CheckTokenMembershipEx 関数 (securitybaseapi.h)

CheckTokenMembershipEx 関数は、指定した SID が指定されたトークンで有効になっているかどうかを判断します。

構文

BOOL CheckTokenMembershipEx(
  [in, optional] HANDLE TokenHandle,
  [in]           PSID   SidToCheck,
  [in]           DWORD  Flags,
  [out]          PBOOL  IsMember
);

パラメーター

[in, optional] TokenHandle

アクセス トークンへのハンドル。 存在する場合、このトークンは SID に対してチェックされます。 存在しない場合は、現在の有効なトークンが使用されます。 これは偽装トークンである必要があります。

[in] SidToCheck

SID 構造体へのポインター。 この関数は、トークンが存在する場合に、この SID が存在していることを確認します。

[in] Flags

関数の動作に影響を与えるフラグ。 現在、唯一の有効なフラグは CTMF_INCLUDE_APPCONTAINER であり、指定されたグループが存在し、有効になっているなど、トークンの他の要件が満たされている限り、アプリ コンテナーが呼び出しを渡すことができます。

[out] IsMember

トークン で SID が有効になっている場合は TRUE。それ以外の場合は FALSE。

戻り値

関数が成功すると、 TRUE が返されます。

関数が失敗すると、0 が返されます。 詳細なエラー情報を得るには、GetLastError を呼び出します。

要件

サポートされている最小のクライアント	Windows 8 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	securitybaseapi.h (Windows.h を含む)
Library	Advapi32.lib
[DLL]	Kernel32.dll