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 の任意の属性。
| 値 | 意味 |
|---|---|
|
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 |