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

  • Статья

Создает новый объект диспетчера транзакций (TM) и возвращает дескриптор с указанным доступом.

Синтаксис

HANDLE CreateTransactionManager(
  [in, optional] LPSECURITY_ATTRIBUTES lpTransactionAttributes,
  [in, optional] LPWSTR                LogFileName,
  [in, optional] ULONG                 CreateOptions,
  [in, optional] ULONG                 CommitStrength
);

Параметры

[in, optional] lpTransactionAttributes

Транзакция SECURITY_ATTRIBUTES (ACL) для объекта TM.

[in, optional] LogFileName

Имя потока файла журнала. Если поток не существует в журнале, он создается. Чтобы создать переменную TM, этот параметр должен иметь значение NULL , а CreateOptions должен указывать TRANSACTION_MANAGER_VOLATILE, этот диспетчер транзакций считается переменным.

[in, optional] CreateOptions

Любые необязательные атрибуты для новой TM.

Значение Значение
TRANSACTION_MANAGER_VOLATILE
 Указывает, что TM является переменным и не выполняет восстановление.

[in, optional] CommitStrength

Защищены; укажите ноль.

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

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

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

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

Комментарии

Сразу после вызова этой функции необходимо вызвать RecoverTransactionManager.

Если диспетчер транзакций является переменным, все диспетчеры ресурсов также должны быть нестабильными.

Чтобы TM правильно функционировала, необходимо вызвать RecoverTransactionManager после создания TM.

Требования

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

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

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

OpenTransactionManager

RecoverTransactionManager

SECURITY_ATTRIBUTES