IRowsetFastLoad::Commit (OLE DB)

Применимо: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure azure Synapse Analytics Analytics Platform System (PDW)

Скачать драйвер 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 Driver for SQL Server ведет себя так же, как набор строк в режиме отложенного обновления. По мере вставки пользователем данных строк с помощью набора строк добавленные строки обрабатываются таким же образом, как и ожидающие выполнения вставки для набора строк, поддерживающего IRowsetUpdate.

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

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

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

См. также

IRowsetFastLoad (OLE DB)