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 포함)
라이브러리	Advapi32.lib
DLL	Kernel32.dll