IsTokenRestricted 함수(securitybaseapi.h)

  • 아티클

IsTokenRestricted 함수는 토큰에 제한된 SID(보안 식별자) 목록이 포함되어 있는지 여부를 나타냅니다.

구문

BOOL IsTokenRestricted(
  [in] HANDLE TokenHandle
);

매개 변수

[in] TokenHandle

테스트할 액세스 토큰에 대한 핸들입니다.

반환 값

토큰에 제한 SID 목록이 포함된 경우 반환 값은 0이 아닌 값입니다.

토큰에 제한 SID 목록이 없는 경우 반환 값은 0입니다.

오류가 발생하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

CreateRestrictedToken 함수는 SID를 사용하지 않도록 설정, 권한 삭제 및 SID 제한 목록을 지정하여 토큰을 제한할 수 있습니다. IsTokenRestricted 함수는 SID 제한 목록에 대해서만 확인합니다. 토큰에 제한 SID가 없는 경우 IsTokenRestricted는 CreateRestrictedToken 호출을 통해 토큰을 만들었음에도 불구하고 FALSE를 반환합니다.

요구 사항

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

추가 정보

Access Control 개요

기본 Access Control 함수

CreateRestrictedToken