IRowsetFastLoad::Commit (OLE DB)

Применимо к: SQL Server Azure SQL DatabaseУправляемый экземпляр SQL AzureAzure Synapse Analytics AnalyticsPlatform 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.

Remarks

Набор строк массового копирования 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)