IRowsetFastLoad::Commit (OLE DB)
Marca el final de un lote de filas insertadas y escribe las filas en la tabla SQL Server. Para obtener ejemplos, vea Copiar datos de forma masiva mediante IRowsetFastLoad (OLE DB) y Enviar datos de 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 llamó al método en un conjunto de filas de copia masiva previamente invalidado por el método IRowsetFastLoad::Commit.
Comentarios
Un conjunto de filas de copia masiva del proveedor OLE DB de SQL Server Native Client se comporta como un conjunto de filas en modo 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 utiliza 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 llamando 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.