IRowsetFastLoad::Commit (proveedor de OLE DB Native Client)

Se aplica a: síSQL Server (todas las versiones admitidas) SíAzure SQL Database SíInstancia administrada de Azure SQL síAzure Synapse Analytics síAlmacenamiento de datos paralelos

Marca el final de un lote de filas insertadas y escribe las filas en la tabla SQL Server . Para ver ejemplos, consulte Copiar datos de forma masiva mediante IRowsetFastLoad (OLE DB) y Enviar datos BLOB a SQL SERVER mediante IROWSETFASTLOAD e ISEQUENTIALSTREAM (OLE DB).

Sintaxis

  
HRESULT Commit(  
      BOOL fDone);  

Argumentos

fDone[in]
Si es FALSE, el conjunto de filas mantiene la validez y el consumidor puede usarlo para una inserción de filas adicional. Si es TRUE, el conjunto de filas pierde su validez y el consumidor no puede realizar ninguna inserción más.

Valores de código de retorno

S_OK
El método se ejecutó correctamente y todos los datos insertados se escribieron en la tabla SQL Server.

E_FAIL
Se produjo un error específico del proveedor. Recupere la información de error para el texto de error específico del proveedor.

E_UNEXPECTED
Se ha llamado al método en un conjunto de filas de copia masiva previamente invalidado por el método IRowsetFastLoad::Commit.

Observaciones

Un conjunto de filas OLE DB de copia masiva del proveedor de Native Client se comporta como un conjunto de filas en modo SQL Server de actualización retrasada. A medida que el usuario inserta los datos de fila a través del conjunto de filas, las filas insertadas reciben el mismo trato que las inserciones pendientes en un conjunto de filas que admite IRowsetUpdate.

El consumidor debe llamar al método Commit en el conjunto de filas de copia masiva para escribir las filas insertadas en la tabla de SQL Server del mismo modo en que se usa el método IRowsetUpdate::Update para enviar las filas pendientes a una instancia de SQL Server.

Si el consumidor libera su referencia en el conjunto de filas de copia masiva sin llamar al método Commit, se perderán todas las filas insertadas que no se hayan escrito previamente.

El consumidor puede procesar por lotes las filas insertadas mediante una llamada al método Commit con el argumento fDone establecido en FALSE. Cuando fDone se establece en TRUE, el conjunto de filas deja de ser válido. Un conjunto de filas de copia masiva que no es válido solo admite la interfaz ISupportErrorInfo y el método IRowsetFastLoad::Release.

Consulte también

IRowsetFastLoad (OLE DB)