Поделиться через


IRowsetFastLoad::Commit (OLE DB)

Обозначает конец пакета вставляемых строк и записывает эти строки в таблицу SQL Server.

Синтаксис

        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.

См. также

Другие ресурсы