IRowsetFastLoad::Commit (OLE DB)

Помечает конец пакета вставленных строк и записывает строки в таблицу SQL Server. Примеры см. в статьях о массовом копировании данных с помощью IRowsetFastLoad (OLE DB) и отправки данных BLOB в SQL SERVER с помощью IROWSETFASTLOAD и ISEQUENTIALSTREAM (OLE DB).

Синтаксис

  
HRESULT Commit(  
BOOL   
fDone  
);  
  

Аргументы

fDone[in]
Если значение FALSE, набор строк сохраняет допустимость и может использоваться потребителем для дополнительной вставки строк. Если значение TRUE, набор строк теряет допустимость, и никакие дальнейшие вставки не могут выполняться потребителем.

Значения кода возврата

S_OK
Метод успешно выполнен и все вставленные данные записываются в таблицу SQL Server.

E_FAIL
Произошла ошибка для конкретного поставщика. Получение сведений об ошибке для конкретного текста ошибки от поставщика.

E_UNEXPECTED
Метод был вызван в набор строк массового копирования, ранее недопустимый методом IRowsetFastLoad::Commit .

Замечания

Поставщик OLE DB собственного клиента SQL Server ведет себя как набор строк отложенного обновления. Так как пользователь вставляет данные строк через набор строк, вставленные строки обрабатываются таким же образом, как ожидающие вставки в набор строк, поддерживающий IRowsetUpdate.

Потребитель должен вызвать метод Commit в наборе строк массового копирования, чтобы записать вставленные строки в таблицу SQL Server так же, как метод IRowsetUpdate::Update используется для отправки ожидающих строк экземпляру SQL Server.

Если потребитель освобождает ссылку на набор строк массового копирования без вызова метода Commit , все вставленные строки, не записанные ранее, будут потеряны.

Потребитель может пакетировать вставленные строки, вызвав метод Commit с аргументом fDone , равным FALSE. Если для fDoneзадано значение TRUE, набор строк становится недопустимым. Недопустимый набор строк массового копирования поддерживает только интерфейс ISupportErrorInfo и метод IRowsetFastLoad::Release .

См. также

IRowsetFastLoad (OLE DB)