IRowsetFastLoad::Commit (OLE DB)
Обозначает конец пакета вставляемых строк и записывает эти строки в таблицу SQL Server. Дополнительные сведения см. в разделах Выполнение массового копирования данных с использованием интерфейса IRowsetFastLoad (OLE DB) и Отправка данных BLOB на SQL Server через интерфейсы IRowsetFastLoad и ISequentialStream (OLE DВ).
Синтаксис
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.