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

  • Статья

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

Синтаксис

HANDLE CreateResourceManager(
  [in, optional] LPSECURITY_ATTRIBUTES lpResourceManagerAttributes,
  [in]           LPGUID                ResourceManagerId,
  [in, optional] DWORD                 CreateOptions,
  [in]           HANDLE                TmHandle,
  [in, optional] LPWSTR                Description
);

Параметры

[in, optional] lpResourceManagerAttributes

Указатель на структуру SECURITY_ATTRIBUTES , содержащую атрибуты безопасности для диспетчера ресурсов. Укажите ЗНАЧЕНИЕ NULL , чтобы получить атрибуты по умолчанию.

[in] ResourceManagerId

Указатель на GUID диспетчера ресурсов. Этот параметр является обязательным и не должен иметь значение NULL.

[in, optional] CreateOptions

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

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

[in] TmHandle

Дескриптор для TM, который будет управлять транзакциями для этого RM.

[in, optional] Description

Описание для этого RM.

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

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

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

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

Комментарии

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

RM — это конечная точка для уведомлений TM о транзакциях, к которым она прикреплена.

RM обычно являются постоянными. Это означает, что после сбоя системы их необходимо повторно открыть для выполнения определенных операций. Временные или временные RM можно создать, вызвав функцию CreateResourceManager и указав RESOURCE_MANAGER_VOLATILE. Переменные RM не выполняют операции восстановления, но требуют уведомлений о транзакции.

Вы можете создать переменную RM на устойчивом TM, но нельзя создать устойчивый RM на переменной TM.

Требования

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

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

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

OpenResourceManager

SECURITY_ATTRIBUTES

SetResourceManagerCompletionPort