RtlIntPtrToUnicodeString 매크로(wdm.h)

RtlIntPtrToUnicodeString 루틴은 지정된 ULONG_PTR 값을 지정된 베이스의 값을 나타내는 유니코드 문자열로 변환합니다.

구문

void RtlIntPtrToUnicodeString(
  [in]            Value,
  [in, optional]  Base,
  [in, out]       String
);

[in] Value

변환할 ULONG_PTR 값을 지정합니다.

[in, optional] Base

값을 문자열로 변환할 때 사용할 기본을 지정합니다. 가능한 값은 다음과 같습니다.

[in, out] String

Value의 문자열 표현을 수신하는 UNICODE_STRING 구조체에 대한 포인터입니다. 버퍼 of String에서 지정한 버퍼는 결과를 저장할 수 있을 만큼 커야 합니다.

없음

RtlIntPtrToUnicodeString 은 NTSTATUS 값을 반환합니다. 가능한 반환 값은 다음과 같습니다.

반환 코드	설명
STATUS_SUCCESS	루틴이 값을 유니코드 문자열로 변환했습니다.
STATUS_BUFFER_OVERFLOW	값이 너무 커서 변환할 수 없거나 UNICODE_STRING 구조가 너무 작아서 결과를 보유할 수 없습니다.
STATUS_INVALID_PARAMETER	지정된 코드 베이스가 잘못되었습니다. 유효한 값은 0, 2, 8, 10 및 16뿐입니다.

요구 사항	값
지원되는 최소 클라이언트	Windows 2000부터 사용할 수 있습니다.
대상 플랫폼	데스크톱
머리글	wdm.h(Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL