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 |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | ktmw32.h |
| ライブラリ | Ktmw32.lib |
| DLL | Ktmw32.dll |
関連項目
カーネル トランザクション マネージャー関数 の
SetResourceManagerCompletionPort の