Функция OpenTransaction (ktmw32.h)

  • Статья

Открывает существующую транзакцию.

Синтаксис

HANDLE OpenTransaction(
  [in] DWORD  dwDesiredAccess,
  [in] LPGUID TransactionId
);

Параметры

[in] dwDesiredAccess

Доступ к объекту транзакции. Для работы с транзакцией необходимо иметь доступ на чтение и запись. Список допустимых значений см. в разделе Маски доступа к транзакциям .

[in] TransactionId

ИДЕНТИФИКАТОР GUID, определяющий открываемую транзакцию. Обычно это называется единицей работы для транзакции.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение является дескриптором транзакции.

Если функция завершается неудачно, возвращается значение INVALID_HANDLE_VALUE. Чтобы получить расширенные сведения об ошибке, вызовите функцию GetLastError .

В следующем списке указаны возможные коды ошибок:

Комментарии

Клиенты закрывают дескриптор транзакции с помощью функции CloseHandle . Если последний дескриптор транзакции закрыт без вызова функции CommitTransaction для транзакции, KTM неявно откатывает транзакцию.

Требования

   
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header ktmw32.h
Библиотека Ktmw32.lib
DLL Ktmw32.dll

См. также раздел

CommitTransaction

CreateTransaction

Функции диспетчера транзакций ядра

RollbackTransaction

Маски доступа к транзакциям