IRowsetFastLoad::Commit (OLE DB)
Marque la fin d'un lot de lignes insérées et écrit les lignes dans la table SQL Server.
Syntaxe
HRESULT Commit(
BOOL fDone);
Arguments
- fDone[in]
Si FALSE, l'ensemble de lignes conserve la validation et peut être utilisé par le consommateur pour l'insertion de ligne supplémentaire. Si TRUE, l'ensemble de lignes perd la validation et aucune insertion supplémentaire ne peut être effectuée par le consommateur.
Valeurs de code 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. Extrayez les informations sur l'erreur pour le texte d'erreur spécifique à partir 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.
Notes
Un ensemble de lignes de copie en bloc de fournisseur OLE DB SQL Server Native Client se comporte comme un ensemble de lignes en mode de mise à jour retardée. Étant donné que l'utilisateur insère les données de ligne par le biais de l'ensemble de lignes, les lignes insérées sont traitées de la même façon 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 soumettre 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 insérer des lignes par lot en appelant la méthode Commit avec l'argument fDone défini à FALSE. Lorsque fDone a la valeur TRUE, l'ensemble de lignes devient non valide. Un ensemble de lignes de copie en bloc non valide prend en charge uniquement l'interface ISupportErrorInfo et la méthode IRowsetFastLoad::Release.