PsGetSiloContext 関数 (ntddk.h)

  • [アーティクル]

このルーチンは、指定されたサイロとスロットからサイロ コンテキストを取得します。

構文

NTSTATUS PsGetSiloContext(
  [in] PESILO Silo,
  [in] ULONG  ContextSlot,
       PVOID  *ReturnedSiloContext
);

パラメーター

[in] Silo

サイロ コンテキストが存在するサイロ。 このパラメーターは必須であり、 NULL にすることはできません。

[in] ContextSlot

サイロ コンテキストが存在するスロット。 PsAllocSiloContextSlot ルーチンによって割り当てられたスロット。

ReturnedSiloContext

サイロ コンテキストへの参照ポインターを受け取ります。 失敗した場合、受信した値は NULL になります。

戻り値

次の NT 状態コードが返されます。

リターン コード 説明
STATUS_NOT_FOUND
 サイロ コンテキストが見つからない場合の状態コード。
STATUS_INVALID_PARAMETER
 無効なスロット番号が ContextSlot パラメーターとして指定された場合の状態コード。
STATUS_SUCCESS
 操作は正常に完了しました。

注釈

PsGetSiloContext ルーチンは、指定されたサイロに挿入されたオブジェクトを取得します。 このルーチンの呼び出しが成功すると、 ReturnedSiloContext パラメーターが指すオブジェクトの参照カウントがインクリメントされます。 ReturnedSiloContext パラメーターが指すオブジェクトは、不要になったら PsDereferenceSiloContext を呼び出してデクリメントする必要があります。 プロセスがなくなったり 、NtTerminateJobObject を特定の呼び出しでサイロが終了したりする場合、コンテキスト スロットが空になる可能性があります。 この場合の戻り値の状態は STATUS_NOT_FOUND。

要件

要件 値
サポートされている最小のクライアント Windows 10 Version 1607
サポートされている最小のサーバー Windows Server 2016
対象プラットフォーム Windows
ヘッダー ntddk.h