NtPrivilegeCheck 関数 (ntifs.h)

[アーティクル]
02/29/2024

NtPrivilegeCheck は、システムで使用するために予約されています。

構文

__kernel_entry NTSYSCALLAPI NTSTATUS NtPrivilegeCheck(
  [in]      HANDLE         ClientToken,
  [in, out] PPRIVILEGE_SET RequiredPrivileges,
  [out]     PBOOLEAN       Result
);

パラメーター

[in] ClientToken

アクセスを試みるクライアントを表すトークンオブジェクトへのハンドル。このハンドルは、セキュリティポリシー違反の可能性を防ぐために、LPC ポートやローカル名前付きパイプなどの通信セッション層から取得する必要があります。

[in, out] RequiredPrivileges

PRIVILEGE_SET構造体へのポインター。この構造体の Privilege メンバーは、LUID_AND_ATTRIBUTES構造体の配列です。 SePrivilegeCheck を呼び出す前に、Privilege 配列を使用して、チェックする権限のセットを示します。すべての特権を有効にする必要がある場合は、 Control メンバーを PRIVILEGE_SET_ALL_NECESSARY に設定します。または、いずれかの特権を有効にするだけで十分な場合は、0 に設定します。

[out] Result

クライアントが指定されたすべての特権を持っているかどうかを示すブール値フラグを受け取ります。値 TRUE は、クライアントに指定されたすべての特権があることを示します。それ以外の場合は、FALSE の値が返されます。

戻り値

NtPrivilegeCheck は 、正常に完了するとSTATUS_SUCCESSを返します。それ以外の場合は、次のようなエラーコードが返されます。

リターンコード	説明
STATUS_PRIVILEGE_NOT_HELD	呼び出し元には、この特権システムサービスを使用するための十分な特権がありません。

注釈

アクセストークンには、トークンに関連付けられているアカウントによって保持されている特権の一覧が含まれます。これらの特権は有効または無効にすることができます。は既定で無効になっています。 NtPrivilegeCheck は 、有効な特権のみをチェックします。アクセストークンによって保持されているすべての有効および無効な特権の一覧を取得するには、 SeQueryInformationToken を呼び出します。

セキュリティとアクセス制御の詳細については、ドライバー開発者向けの Windows セキュリティモデルと、Windows SDK のこれらのトピックに関するドキュメントを参照してください。