Функция 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.
| Значение | Значение |
|---|---|
|
Указывает, что 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 |