RtlConvertSidToUnicodeString 함수(winternl.h)

  • 아티클

[ RtlConvertSidToUnicodeString 함수는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. 대신 ConvertSidToStringSid 함수를 사용합니다.]

RtlConvertSidToUnicodeString 함수는 SID(보안 식별자)를 유니코드 문자 표현으로 변환합니다. 이 함수에는 연결된 가져오기 라이브러리가 없습니다. LoadLibrary 및 GetProcAddress 함수를 사용하여 Ntdll.dll 동적으로 연결해야 합니다.

구문

NTSTATUS RtlConvertSidToUnicodeString(
  [out] PUNICODE_STRING UnicodeString,
  [in]  PSID            Sid,
  [in]  BOOLEAN         AllocateDestinationString
);

매개 변수

[out] UnicodeString

보안 식별자의 유니코드 문자 표현에 대한 포인터입니다.

[in] Sid

보안 식별자를 나타내는 SID 구조체에 대한 포인터입니다.

[in] AllocateDestinationString

TRUE이면 호출자를 대신하여 UnicodeString이 할당되며, RtlFreeUnicodeString 함수를 호출하여 할당된 메모리를 해제하는 것은 호출자의 책임입니다. FALSE이면 호출자는 UnicodeString을 할당하고 해제할 책임이 있습니다.

반환 값

반환 값은 NTSTATUS 코드입니다. 함수가 성공하면 STATUS_SUCCESS(0x00000000L) 값이 반환됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 winternl.h
라이브러리 ntdll.lib
DLL ntdll.dll