CreateWellKnownSid 함수(securitybaseapi.h)

CreateWellKnownSid 함수는 미리 정의된 별칭에 대한 SID를 만듭니다.

구문

BOOL CreateWellKnownSid(
  [in]            WELL_KNOWN_SID_TYPE WellKnownSidType,
  [in, optional]  PSID                DomainSid,
  [out, optional] PSID                pSid,
  [in, out]       DWORD               *cbSid
);

매개 변수

[in] WellKnownSidType

SID가 식별할 내용을 지정하는 WELL_KNOWN_SID_TYPE 열거형의 멤버입니다.

[in, optional] DomainSid

SID를 만들 때 사용할 도메인을 식별하는 SID에 대한 포인터입니다. NULL을 전달하여 로컬 컴퓨터를 사용합니다.

[out, optional] pSid

CreateWellKnownSid가 새 SID를 저장할 메모리에 대한 포인터입니다.

[in, out] cbSid

pSid에서 사용할 수 있는 바이트 수를 포함하는 DWORD에 대한 포인터입니다. CreateWellKnownSid 함수는 이 위치에 실제로 사용되는 바이트 수를 저장합니다.

반환 값

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

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

요구 사항

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

추가 정보

EqualDomainSid

GetWindowsAccountDomainSid

IsWellKnownSid

WELL_KNOWN_SID_TYPE