IRowsetFastLoad ::Commit (fournisseur OLE DB native client)
S’applique à :
SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
Important
SQL Server Native Client (souvent abrégé en SNAC) a été supprimé dans SQL Server 2022 (16.x) et SQL Server Management Studio 19 (SSMS). Le fournisseur OLE DB pour SQL Server Native Client (SQLNCLI ou SQLNCLI11) et le fournisseur Microsoft OLE DB hérité pour SQL Server (SQLOLEDB) ne sont pas recommandés dans les nouveaux développements. Utilisez à la place le nouveau Microsoft OLE DB Driver (MSOLEDBSQL) pour SQL Server.
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 Copier des données en bloc avec IRowsetFastLoad (OLE DB) et Envoyer des données BLOB vers SQL Server en utilisant IROWSETFASTLOAD et ISEQUENTIALSTREAM (OLE DB).
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.
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. 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 du fournisseur OLE DB SQL Server Native Client se comporte comme un ensemble de lignes en mode de mise à jour différée. Quand l’utilisateur insère des données de ligne dans 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 les 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 sur FALSE. Quand fDone est défini sur TRUE, l’ensemble de lignes devient non valide. Un ensemble de lignes de copie en bloc non valide prend en charge seulement l’interface ISupportErrorInfo et la méthode IRowsetFastLoad::Release.