IRowsetFastLoad::Commit (поставщик OLE DB собственного клиента)

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

Внимание

Собственный клиент SQL Server (часто сокращенный SNAC) был удален из SQL Server 2022 (16.x) и SQL Server Management Studio 19 (SSMS). Поставщик OLE DB собственного клиента SQL Server (SQLNCLI или SQLNCLI11) и устаревший поставщик Microsoft OLE DB для SQL Server (SQLOLEDB) не рекомендуется для новой разработки. Перейдите на новый драйвер Microsoft OLE DB (MSOLEDBSQL) для SQL Server .

Помечает конец пакета вставленных строк и записывает строки в таблицу 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)