NtCreateResourceManager 関数 (wdm.h)

[アーティクル]
03/08/2024

ZwCreateResourceManager ルーチンは、リソースマネージャーオブジェクトを作成します。

構文

__kernel_entry NTSYSCALLAPI NTSTATUS NtCreateResourceManager(
  [out]          PHANDLE            ResourceManagerHandle,
  [in]           ACCESS_MASK        DesiredAccess,
  [in]           HANDLE             TmHandle,
  [in]           LPGUID             RmGuid,
  [in, optional] POBJECT_ATTRIBUTES ObjectAttributes,
  [in, optional] ULONG              CreateOptions,
  [in, optional] PUNICODE_STRING    Description
);

パラメーター

[out] ResourceManagerHandle

ZwCreateResourceManager の呼び出しが成功した場合に、新しいリソースマネージャーオブジェクトへのハンドルを受け取る呼び出し元割り当て変数へのポインター。

[in] DesiredAccess

リソースマネージャーオブジェクトへの呼び出し元の要求されたアクセス権を指定する ACCESS_MASK 値。呼び出し元は、すべての種類のオブジェクトに対して定義されているアクセス権 ( ACCESS_MASKを参照) に加えて、リソースマネージャーオブジェクトに対して次のいずれかのアクセス権限フラグを指定できます。

ACCESS_MASK フラグ	呼び出し元が
RESOURCEMANAGER_ENLIST	トランザクションに参加します ( ZwCreateEnlistment を参照)。
RESOURCEMANAGER_GET_NOTIFICATION	このリソースマネージャーに関連付けられているトランザクションに関する通知を受け取ります ( 「ZwGetNotificationResourceManager」を参照)。
RESOURCEMANAGER_REGISTER_PROTOCOL	使用されていません。
RESOURCEMANAGER_QUERY_INFORMATION	リソースマネージャーに関するクエリ情報 ( 「ZwQueryInformationResourceManager」を参照)。
RESOURCEMANAGER_SET_INFORMATION	使用されていません。
RESOURCEMANAGER_RECOVER	リソースマネージャーを復旧します ( ZwRecoverResourceManager を参照)。
RESOURCEMANAGER_COMPLETE_PROPAGATION	使用されていません。

または、次の汎用ACCESS_MASK フラグの 1 つ以上を指定することもできます。 (STANDARD_RIGHTS_Xxx フラグは、システムオブジェクトにセキュリティを適用するために使用される定義済みのシステム値です)。これらの汎用フラグを、前の表の追加フラグと組み合わせることもできます。次の表は、一般的なアクセス権が特定のアクセス権にどのように対応するかを示しています。

汎用アクセス権	特定のアクセス権のセット
RESOURCEMANAGER_GENERIC_READ	STANDARD_RIGHTS_READ、RESOURCEMANAGER_QUERY_INFORMATION、SYNCHRONIZE
RESOURCEMANAGER_GENERIC_WRITE	STANDARD_RIGHTS_WRITE、RESOURCEMANAGER_SET_INFORMATION、RESOURCEMANAGER_RECOVER、RESOURCEMANAGER_ENLIST、RESOURCEMANAGER_GET_NOTIFICATION、RESOURCEMANAGER_REGISTER_PROTOCOL、RESOURCEMANAGER_COMPLETE_PROPAGATION、SYNCHRONIZE
RESOURCEMANAGER_GENERIC_EXECUTE	STANDARD_RIGHTS_EXECUTE、RESOURCEMANAGER_RECOVER、RESOURCEMANAGER_ENLIST、RESOURCEMANAGER_GET_NOTIFICATION、RESOURCEMANAGER_COMPLETE_PROPAGATION、SYNCHRONIZE
RESOURCEMANAGER_ALL_ACCESS	STANDARD_RIGHTS_REQUIRED、RESOURCEMANAGER_GENERIC_READ、RESOURCEMANAGER_GENERIC_WRITE、RESOURCEMANAGER_GENERIC_EXECUTE

[in] TmHandle

ZwCreateTransactionManager または ZwOpenTransactionManager の前の all によって取得されたトランザクションマネージャーオブジェクトへのハンドル。

[in] RmGuid

KTM がリソースマネージャーを識別するために使用する GUID へのポインター。このポインターが NULL の場合、KTM は GUID を生成します。

[in, optional] ObjectAttributes

オブジェクト名とその他の属性を指定する OBJECT_ATTRIBUTES 構造体へのポインター。 InitializeObjectAttributes ルーチンを使用して、この構造体を初期化します。呼び出し元がシステムスレッドコンテキストで実行されていない場合は、 InitializeObjectAttributes を呼び出すときにOBJ_KERNEL_HANDLE属性を設定する必要があります。このパラメーターは省略可能であり、 NULL にすることができます。

[in, optional] CreateOptions

省略可能なオブジェクト作成フラグ。次の表に、Ktmtypes.h で定義されている使用可能なフラグを示します。

CreateOptions フラグ	意味
RESOURCE_MANAGER_COMMUNICATION	内部使用専用です。
RESOURCE_MANAGER_VOLATILE	呼び出し元は揮発性リソースを管理します。非永続的であり、復旧は実行されません。

このパラメーターは省略可能であり、0 にすることができます。

[in, optional] Description

NULL で終わる文字列を含む呼び出し元から提供される UNICODE_STRING 構造体へのポインター。文字列は、リソースマネージャーの説明を提供します。 KTM は、文字列のコピーを格納し、ログストリームに書き込むメッセージに文字列を含めます。文字列の最大長はMAX_RESOURCEMANAGER_DESCRIPTION_LENGTH。このパラメーターは省略可能であり、 NULL にすることができます。

戻り値

操作が成功した場合、ZwCreateResourceManager はSTATUS_SUCCESSを返します。それ以外の場合、このルーチンは次のいずれかの値を返す可能性があります。

リターンコード	説明
STATUS_OBJECT_TYPE_MISMATCH	TmHandle が指定するハンドルは、トランザクションオブジェクトへのハンドルではありません。
STATUS_INVALID_HANDLE	TmHandle が指定するハンドルが無効です。
STATUS_ACCESS_DENIED	呼び出し元には、指定されたトランザクションマネージャーオブジェクトへの適切なアクセス権がありません。
STATUS_TRANSACTION_OBJECT_EXPIRED	TmHandle が指定するハンドルが閉じられます。
STATUS_INVALID_PARAMETER	CreateOptions パラメーターの値が無効であるか、Description パラメーターの文字列が長すぎます。
STATUS_TM_VOLATILE	CreateOptions パラメーターはRESOURCE_MANAGER_VOLATILEを指定しませんが、TmHandle で指定されるトランザクションマネージャーは揮発性です。
STATUS_OBJECT_NAME_COLLISION	ResourceManagerGuid で指定されている GUID は既に存在します。
STATUS_ACCESS_DENIED	DesiredAccess パラメーターの値が無効です。

ルーチンは、他の NTSTATUS 値を返す場合があります。

注釈

ZwCreateResourceManager を呼び出すリソースマネージャーは、オブジェクトハンドルを閉じるには、最終的に ZwClose を呼び出す必要があります。

ZwCreateResourceManager の詳細については、「Resource Managerの作成」を参照してください。

カーネルモードドライバーからの呼び出しの場合、Windows ネイティブシステムサービスルーチンの NtXxx および ZwXxx バージョンは、入力パラメーターを処理および解釈する方法で動作が異なる場合があります。 ルーチンの NtXxx バージョンと ZwXxx バージョンの間の関係の詳細については、「ネイティブシステムサービスルーチンの Nt バージョンと Zw バージョンの使用」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降のオペレーティングシステムバージョンで使用できます。
対象プラットフォーム	ユニバーサル
Header	wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則	HwStorPortProhibitedDDIs、PowerIrpDDis