次の方法で共有


NtOpenEnlistment 関数 (wdm.h)

ZwOpenEnlistment ルーチンは、既存の参加オブジェクトへのハンドルを取得します。

構文

__kernel_entry NTSYSCALLAPI NTSTATUS NtOpenEnlistment(
  [out]          PHANDLE            EnlistmentHandle,
  [in]           ACCESS_MASK        DesiredAccess,
  [in]           HANDLE             ResourceManagerHandle,
  [in]           LPGUID             EnlistmentGuid,
  [in, optional] POBJECT_ATTRIBUTES ObjectAttributes
);

パラメーター

[out] EnlistmentHandle

ZwOpenEnlistment への呼び出しが成功した場合に、参加オブジェクトへのハンドルを受け取る呼び出し元割り当て変数へのポインター。

[in] DesiredAccess

参加オブジェクトへの要求されたアクセスを指定する、 ACCESS_MASK型指定された値。 このパラメーターを指定する方法の詳細については、ZwCreateEnlistmentDesiredAccess パラメーターを参照してください。 このパラメーターを 0 にすることはできません。

[in] ResourceManagerHandle

ZwCreateResourceManager または ZwOpenResourceManager の以前の呼び出しによって取得されたリソース マネージャー オブジェクトへのハンドル。

[in] EnlistmentGuid

参加リストを識別する GUID へのポインター。 詳細については、「解説」を参照してください。

[in, optional] ObjectAttributes

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

戻り値

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

リターン コード 説明
STATUS_INVALID_HANDLE
オブジェクト ハンドルが無効です。
STATUS_ACCESS_DENIED
呼び出し元には、参加オブジェクトへの適切なアクセス権がありません。
STATUS_INVALID_PARAMETER
DesiredAccess パラメーターの値が 0 であるか、EnlistmentGuid パラメーターの値が NULL です
STATUS_ENLISTMENT_NOT_FOUND
RmHandle パラメーターが指定するリソース マネージャーに対して EnlistmentGuid パラメーターが指定する参加リストが存在しません。
STATUS_ACCESS_DENIED
DesiredAccess パラメーターの値が無効です。
 

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

注釈

通常、TPS コンポーネントは、以前 に ZwCreateEnlistment と呼ばれた別の TPS コンポーネントから参加 GUID を受信した後、 ZwOpenEnlistment を呼び出します。 ほとんどの TPS 設計では 、ZwOpenEnlistment を呼び出す必要はありません。

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

ZwOpenEnlistment の詳細については、「オブジェクトの参加」を参照してください。

NtOpenEnlistmentZwOpenEnlistment は、同じ Windows ネイティブ システム サービス ルーチンの 2 つのバージョンです。

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

要件

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

こちらもご覧ください

ACCESS_MASK

InitializeObjectAttributes

OBJECT_ATTRIBUTES

Nt および Zw バージョンのネイティブ システム サービス ルーチンの使用

ZwClose

ZwCreateEnlistment

ZwCreateResourceManager

ZwOpenResourceManager

ZwQueryInformationEnlistment

ZwSetInformationEnlistment