IRowsetFastLoad ::Commit (OLE DB)

Marque la fin d’un lot de lignes insérées et écrit les lignes dans la table SQL Server. Pour obtenir des exemples, consultez La copie en bloc des données à l’aide d’IRowsetFastLoad (OLE DB) et l’envoi de données BLOB à SQL SERVER à l’aide d’IROWSETFASTLOAD et d’ISEQUENTIALSTREAM (OLE DB).

Syntaxe

  
HRESULT Commit(  
BOOL   
fDone  
);  
  

Les arguments

fDone[in]
Si la valeur est FALSE, l’ensemble de lignes conserve la validité et peut être utilisé par le consommateur pour une insertion de ligne supplémentaire. Si la valeur est TRUE, l’ensemble de lignes perd la validité et aucune autre insertion ne peut être effectuée par le consommateur.

Codet de retour

S_OK
La méthode a réussi et toutes les données insérées ont été écrites dans la table SQL Server.

E_FAIL
Une erreur spécifique au fournisseur s’est produite. Récupérez les informations d’erreur pour le texte d’erreur spécifique du fournisseur.

E_UNEXPECTED
La méthode a été appelée sur un ensemble de lignes de copie en bloc précédemment invalidé par la méthode IRowsetFastLoad ::Commit .

Remarques

Un ensemble de lignes de copie en bloc du fournisseur OLE DB SQL Server Native Client se comporte comme un ensemble de lignes en mode de mise à jour différée. Lorsque l’utilisateur insère des données de ligne via l’ensemble de lignes, les lignes insérées sont traitées de la même manière que les insertions en attente sur un ensemble de lignes prenant en charge IRowsetUpdate.

Le consommateur doit appeler la méthode Commit sur l’ensemble de lignes de copie en bloc pour écrire des lignes insérées dans la table SQL Server de la même façon que la méthode IRowsetUpdate ::Update est utilisée pour envoyer des lignes en attente à une instance de SQL Server.

Si le consommateur libère sa référence sur l’ensemble de lignes de copie en bloc sans appeler la méthode Commit , toutes les lignes insérées non écrites précédemment sont perdues.

Le consommateur peut traiter les lignes insérées par lot en appelant la méthode Commit avec l’argument fDone défini sur FALSE. Lorsque fDoneest défini sur TRUE, l’ensemble de lignes devient non valide. Un ensemble de lignes de copie en bloc non valide prend uniquement en charge l’interface ISupportErrorInfo et la méthode IRowsetFastLoad ::Release .

Voir aussi

IRowsetFastLoad (OLE DB)