CreateResourceManager 関数 (ktmw32.h)

新しいリソース・マネージャー (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

この RM のトランザクションを管理する TM へのハンドル。

[in, optional] Description

この RM の説明。

戻り値

関数が成功した場合、戻り値は RM へのハンドルです。

失敗した場合の戻り値は、INVALID_HANDLE_VALUE です。 エラーの詳細情報を得るには、GetLastError 関数を呼び出します。

次の一覧は、考えられるエラー コードを示しています。

注釈

この関数を呼び出した直後に RecoverResourceManager を呼び出す必要があります。

RM は、RM が参加したトランザクションに関する TM 通知のエンドポイントです。

通常、VM は永続的です。つまり、システム障害が発生した後は、特定の操作を実行するために再び開く必要があります。 揮発性の一時的な VM は、 CreateResourceManager 関数を呼び出し、RESOURCE_MANAGER_VOLATILEを指定することで作成できます。 揮発性の VM は復旧操作を実行しませんが、トランザクションに関する通知は必要です。

永続 TM に揮発性 RM を作成することはできますが、揮発性 TM に永続 RM を作成することはできません。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
対象プラットフォーム	Windows
ヘッダー	ktmw32.h
Library	Ktmw32.lib
[DLL]	Ktmw32.dll

こちらもご覧ください

カーネル トランザクション マネージャー関数

OpenResourceManager

SECURITY_ATTRIBUTES

SetResourceManagerCompletionPort