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

Статья
11/20/2024

Создает объект диспетчера транзакций (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.

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

Необходимо вызвать RecoverTransactionManager после создания TM для правильной работы TM.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista
минимальный поддерживаемый сервер	Windows Server 2008
целевая платформа	Виндоус
заголовка	ktmw32.h
библиотеки	Ktmw32.lib
DLL	Ktmw32.dll

См. также

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

OpenTransactionManager

RecoverTransactionManager

SECURITY_ATTRIBUTES

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