RtlInt64ToUnicodeString 루틴은 지정된 부호 없는 64비트 정수 값을 지정된 밑의 값을 나타내는 유니코드 문자열로 변환합니다.
구문
NTSYSAPI NTSTATUS RtlInt64ToUnicodeString(
[in] ULONGLONG Value,
[in, optional] ULONG Base,
[in, out] PUNICODE_STRING String
);
매개 변수
[in] Value
변환할 ULONGLONG 값을 지정합니다.
[in, optional] Base
값을 문자열로 변환할 때 사용할 기본을 지정합니다. 가능한 값은 다음과 같습니다.
| 값 | 기준 |
|---|---|
| 16 | 16진수 |
| 8 | Octal |
| 2 | 이진 |
| 0 또는 10 | Decimal |
[in, out] String
Value의 문자열 표현을 수신하는 UNICODE_STRING 구조체에 대한 포인터입니다. 문자열 버퍼에 지정된 버퍼는 결과를 저장할 수 있을 만큼 커야 합니다.
반환 값
RtlInt64ToUnicodeString 은 NTSTATUS 값을 반환합니다. 가능한 반환 값은 다음과 같습니다.
| 반환 코드 | 설명 |
|---|---|
|
루틴이 Value 를 유니코드 문자열로 변환했습니다. |
|
값 이 너무 커서 변환할 수 없거나 UNICODE_STRING 구조가 너무 작아서 결과를 보유할 수 없습니다. |
|
지정된 코드 베이스가 잘못되었습니다. 유효한 값은 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 |