CheckTokenCapability 関数 (securitybaseapi.h)
CheckTokenCapability 関数は、特定のトークンの機能をチェックします。
構文
BOOL CheckTokenCapability(
[in, optional] HANDLE TokenHandle,
[in] PSID CapabilitySidToCheck,
[out] PBOOL HasCapability
);
パラメーター
[in, optional] TokenHandle
アクセス トークンのハンドル。 ハンドルには、トークンへのTOKEN_QUERYアクセス権が必要です。 トークンは 偽装トークンである必要があります。
TokenHandle が NULL の場合、CheckTokenCapability は呼び出し元スレッドの偽装トークンを使用します。 スレッドが偽装されていない場合、関数はスレッドの プライマリ トークン を複製して 偽装トークンを作成します。
[in] CapabilitySidToCheck
機能 SID 構造体へのポインター。 CheckTokenCapability 関数は、このアクセス トークンの機能をチェックします。
[out] HasCapability
チェックの結果を受信します。 アクセス トークンに機能がある場合は TRUE を返し、それ以外の場合は FALSE を返します。
戻り値
関数が成功すると、戻り値は 0 以外になります。
関数が失敗した場合は、0 を返します。 拡張エラー情報を取得するには、GetLastError を呼び出します
要件
サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | securitybaseapi.h (Windows.h を含む) |
Library | Advapi32.lib |
[DLL] | Kernel32.dll |