RtlIntegerToUnicodeString 함수(wdm.h)

  • 아티클

RtlIntegerToUnicodeString 루틴은 부호 없는 정수 값을 지정된 베이스에 있는 하나 이상의 유니코드 문자의 null로 끝나는 문자열로 변환합니다.

구문

NTSYSAPI NTSTATUS RtlIntegerToUnicodeString(
  [in]           ULONG           Value,
  [in, optional] ULONG           Base,
  [in, out]      PUNICODE_STRING String
);

매개 변수

[in] Value

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

[in, optional] Base

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

값 기준
16 16진수
8 Octal
2 이진
0 또는 10 Decimal

[in, out] String

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

반환 값

RtlIntegerToUnicodeString 은 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(커널 모드); Ntdll.dll(사용자 모드)
IRQL PASSIVE_LEVEL

추가 정보

RtlAppendUnicodeStringToString

RtlUnicodeStringToInteger

UNICODE_STRING