RtlUTF8StringToUnicodeString 함수(wdm.h)

  • 아티클

RtlUTF8StringToUnicodeString 함수는 현재 시스템 로캘 정보에 따라 지정된 UTF8 원본 문자열을 유니코드 문자열로 변환합니다.

구문

NTSYSAPI NTSTATUS RtlUTF8StringToUnicodeString(
  PUNICODE_STRING DestinationString,
  PUTF8_STRING    SourceString,
  BOOLEAN         AllocateDestinationString
);

매개 변수

DestinationString

변환된 유니코드 문자열을 저장할 UNICODE_STRING 구조체에 대한 포인터입니다.

AllocateDestinationString이 TRUE이면 루틴은 문자열 데이터를 저장할 새 버퍼를 할당하고, DestinationString의 Buffer 멤버를 업데이트하여 새 버퍼를 가리키고, 최대 길이 필드를 설정합니다. 그렇지 않으면 루틴은 현재 지정된 버퍼를 사용하여 문자열을 저장합니다.

SourceString

유니코드로 변환할 UTF8 문자열에 대한 포인터입니다.

AllocateDestinationString

이 루틴이 대상 문자열에 대한 버퍼 공간을 할당해야 하는지를 지정합니다. 이 경우 호출자는 RtlFreeUnicodeString을 호출하여 버퍼의 할당을 취소해야 합니다.

반환 값

변환에 성공하면 RtlUTF8StringToUnicodeString 은 STATUS_SUCCESS 반환합니다. 실패 시 루틴은 메모리를 할당하거나 변환을 수행하지 않습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10, 버전 2004
머리글 wdm.h
IRQL PASSIVE_LEVEL

추가 정보

RtlFreeUnicodeString