GetSidSubAuthority 함수(securitybaseapi.h)

GetSidSubAuthority 함수는 SID(보안 식별자)에서 지정된 하위 권한에 대한 포인터를 반환합니다. 하위 인증 값은 RID( 상대 식별자 )입니다.

구문

PDWORD GetSidSubAuthority(
  [in] PSID  pSid,
  [in] DWORD nSubAuthority
);

[in] pSid

하위 인증에 대한 포인터를 반환할 SID 구조체에 대한 포인터입니다.

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

[in] nSubAuthority

함수가 반환할 주소의 하위 인증 배열 요소를 식별하는 인덱스 값을 지정합니다. 함수는 이 값에 대한 유효성 검사 테스트를 수행하지 않습니다. 애플리케이션은 GetSidSubAuthorityCount 함수를 호출하여 허용되는 값의 범위를 검색할 수 있습니다.

함수가 성공하면 반환 값은 지정된 SID 하위 인증에 대한 포인터입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

함수가 실패하면 반환 값이 정의되지 않습니다. 지정된 SID 구조가 유효하지 않거나 nSubAuthority 매개 변수로 지정된 인덱스 값이 범위를 벗어나면 함수가 실패합니다.

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

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