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

Статья
11/20/2024

Создает новый объект диспетчера ресурсов (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 относительно транзакций, в которые включена служба управления правами.

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

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

Требования

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

См. также

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

OpenResourceManager

SECURITY_ATTRIBUTES

SetResourceManagerCompletionPort

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