GetSidSubAuthorityCount 함수(securitybaseapi.h)

GetSidSubAuthorityCount 함수는 하위 권한 수를 포함하는 SID(보안 식별자) 구조의 멤버에 대한 포인터를 반환합니다.

구문

PUCHAR GetSidSubAuthorityCount(
  [in] PSID pSid
);

[in] pSid

하위 인증 횟수에 대한 포인터가 반환되는 SID 구조체에 대한 포인터입니다.

이 함수는 유효하지 않은 SID 구조를 처리하지 않습니다. IsValidSid 함수를 호출하여 이 함수를 호출하기 전에 SID 구조가 유효한지 확인합니다.

함수가 성공하면 반환 값은 지정된 SID 구조체의 하위 인증 횟수에 대한 포인터입니다.

함수가 실패하면 반환 값이 정의되지 않습니다. 지정된 SID 구조가 유효하지 않으면 함수가 실패합니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

pSid에 지정된 SID 구조체는 32비트 값을 사용합니다. RID 값이 더 긴 애플리케이션의 경우 CreateWellKnownSid 및 관련 함수를 사용합니다.

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