다음을 통해 공유


CheckTokenCapability 함수(securitybaseapi.h)

CheckTokenCapability 함수는 지정된 토큰의 기능을 확인합니다.

구문

BOOL CheckTokenCapability(
  [in, optional] HANDLE TokenHandle,
  [in]           PSID   CapabilitySidToCheck,
  [out]          PBOOL  HasCapability
);

매개 변수

[in, optional] TokenHandle

액세스 토큰에 대한 핸들입니다. 핸들에는 토큰에 대한 TOKEN_QUERY 액세스 권한이 있어야 합니다. 토큰은 가장 토큰이어야 합니다.

TokenHandleNULL인 경우 CheckTokenCapability는 호출 스레드의 가장 토큰을 사용합니다. 스레드가 가장하지 않는 경우 함수는 스레드의 기본 토큰을 복제하여 가장 토큰을 만듭니다.

[in] CapabilitySidToCheck

기능 SID 구조에 대한 포인터입니다. CheckTokenCapability 함수는 이 액세스 토큰의 기능을 확인합니다.

[out] HasCapability

검사 결과를 받습니다. 액세스 토큰에 기능이 있으면 TRUE를 반환하고, 그렇지 않으면 FALSE를 반환합니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 얻으려면 GetLastError를 호출합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 securitybaseapi.h(Windows.h 포함)
라이브러리 Advapi32.lib
DLL Kernel32.dll