InitializeSid 함수(securitybaseapi.h)

아티클
03/01/2024

InitializeSid 함수는 SID(보안 식별자)를 초기화합니다.

구문

BOOL InitializeSid(
  [out] PSID                      Sid,
  [in]  PSID_IDENTIFIER_AUTHORITY pIdentifierAuthority,
  [in]  BYTE                      nSubAuthorityCount
);

매개 변수

[out] Sid

초기화할 SID 구조체에 대한 포인터입니다.

[in] pIdentifierAuthority

SID 구조에서 설정할 SID_IDENTIFIER_AUTHORITY 구조체에 대한 포인터입니다.

[in] nSubAuthorityCount

SID에서 설정할 하위 데이터의 수를 지정합니다. 다음 주의 섹션에 설명된 대로 하위 데이터의 값을 별도로 설정해야 합니다.

반환 값

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

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

설명

InitializeSid 함수는 SID에 대한 하위 인증 수를 설정하지만 하위 인증 값을 설정하지는 않습니다. GetSidSubAuthority와 같은 함수를 사용하여 별도로 수행해야 합니다.

애플리케이션은 AllocateAndInitializeSid 함수를 사용하여 SID를 초기화하고 하위 인증 값을 설정할 수 있습니다.

이 함수는 32비트 RID 값을 사용합니다. 더 큰 RID 값이 필요한 애플리케이션의 경우 CreateWellKnownSid를 사용합니다.

요구 사항

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