AllocateAndInitializeSid 함수(securitybaseapi.h)

아티클
08/25/2023

AllocateAndInitializeSid 함수는 최대 8개의 하위 권한이 있는 SID(보안 식별자)를 할당하고 초기화합니다.

구문

BOOL AllocateAndInitializeSid(
  [in]  PSID_IDENTIFIER_AUTHORITY pIdentifierAuthority,
  [in]  BYTE                      nSubAuthorityCount,
  [in]  DWORD                     nSubAuthority0,
  [in]  DWORD                     nSubAuthority1,
  [in]  DWORD                     nSubAuthority2,
  [in]  DWORD                     nSubAuthority3,
  [in]  DWORD                     nSubAuthority4,
  [in]  DWORD                     nSubAuthority5,
  [in]  DWORD                     nSubAuthority6,
  [in]  DWORD                     nSubAuthority7,
  [out] PSID                      *pSid
);

매개 변수

[in] pIdentifierAuthority

SID_IDENTIFIER_AUTHORITY 구조체에 대한 포인터입니다. 이 구조체는 SID에서 설정할 최상위 식별자 기관 값을 제공합니다.

[in] nSubAuthorityCount

SID에 배치할 하위 데이터의 수를 지정합니다. 또한 이 매개 변수는 의미 있는 값이 있는 하위 인증 매개 변수 수를 식별합니다. 이 매개 변수는 1에서 8까지의 값을 포함해야 합니다.

예를 들어 값 3은 dwSubAuthority0, dwSubAuthority1 및 dwSubAuthority2 매개 변수에 지정된 하위 인증 값에 의미 있는 값이 있고 나머지를 무시함을 나타냅니다.

[in] nSubAuthority0

SID에 배치할 하위 인증 값입니다.

[in] nSubAuthority1

SID에 배치할 하위 인증 값입니다.

[in] nSubAuthority2

SID에 배치할 하위 인증 값입니다.

[in] nSubAuthority3

SID에 배치할 하위 인증 값입니다.

[in] nSubAuthority4

SID에 배치할 하위 인증 값입니다.

[in] nSubAuthority5

SID에 배치할 하위 인증 값입니다.

[in] nSubAuthority6

SID에 배치할 하위 인증 값입니다.

[in] nSubAuthority7

SID에 배치할 하위 인증 값입니다.

[out] pSid

할당되고 초기화된 SID 구조체에 대한 포인터를 수신하는 변수에 대한 포인터입니다.

반환 값

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

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

설명

AllocateAndInitializeSid 함수와 함께 할당된 SID는 FreeSid 함수를 사용하여 해제해야 합니다.

이 함수는 32비트 RID 값으로 SID를 만듭니다. 더 긴 RID 값이 필요한 애플리케이션의 경우 CreateWellKnownSid를 사용합니다.

예제

이 함수를 사용하는 예제는 새 개체에 대한 보안 설명자 만들기 또는 개체 소유권 가져오기를 참조하세요.

요구 사항

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