IRowsetFastLoad::Commit (OLE DB)

Marca o final de um lote de linhas inseridas e grava as linhas na tabela do SQL Server. Para obter exemplos, consulte Copiar dados em massa usando IRowsetFastLoad (OLE DB) e enviar dados blob para o SQL SERVER usando IROWSETFASTLOAD e ISEQUENTIALSTREAM (OLE DB).

Sintaxe

  
HRESULT Commit(  
BOOL   
fDone  
);  
  

Argumentos

fDone[in]
Se FALSE, o conjunto de linhas mantém a validade e pode ser usado pelo consumidor para inserção de linha adicional. Se TRUE, o conjunto de linhas perderá a validade e nenhuma inserção adicional poderá ser feita pelo consumidor.

Valores do código de retorno

S_OK
O método foi bem-sucedido e todos os dados inseridos foram gravados na tabela do SQL Server.

E_FAIL
Ocorreu um erro específico do provedor. Recupere informações de erro para o texto de erro específico do provedor.

E_UNEXPECTED
O método foi chamado em um conjunto de linhas de cópia em massa invalidado anteriormente pelo método IRowsetFastLoad::Commit .

Observações

Um conjunto de linhas de cópia em massa do provedor OLE DB do SQL Server Native Client se comporta como um conjunto de linhas de modo de atualização atrasada. Como o usuário insere dados de linha por meio do conjunto de linhas, as linhas inseridas são tratadas da mesma forma que as inserções pendentes em um conjunto de linhas que dá suporte a IRowsetUpdate.

O consumidor deve chamar o método Commit no conjunto de linhas de cópia em massa para gravar linhas inseridas na tabela do SQL Server da mesma forma que o método IRowsetUpdate::Update é usado para enviar linhas pendentes para uma instância do SQL Server.

Se o consumidor liberar sua referência no conjunto de linhas de cópia em massa sem chamar o método Commit , todas as linhas inseridas não gravadas anteriormente serão perdidas.

O consumidor pode inserir linhas inseridas em lote chamando o método Commit com o argumento fDone definido como FALSE. Quando fDoneé definido como TRUE, o conjunto de linhas torna-se inválido. Um conjunto de linhas de cópia em massa inválido dá suporte apenas à interface ISupportErrorInfo e ao método IRowsetFastLoad::Release .

Consulte Também

IRowsetFastLoad (OLE DB)