rtlIntegerToUnicodeString 函数 (wdm.h)
RtlIntegerToUnicodeString 例程将无符号整数值转换为以 null 结尾的字符串,该字符串由指定基中的一个或多个 Unicode 字符构成。
语法
NTSYSAPI NTSTATUS RtlIntegerToUnicodeString(
[in] ULONG Value,
[in, optional] ULONG Base,
[in, out] PUNICODE_STRING String
);
参数
[in] Value
指定要转换的 ULONG 值。
[in, optional] Base
指定将 Value 转换为字符串时要使用的基。 可能的值包括:
值 | 基本 |
---|---|
16 | 十六进制 |
8 | 八进制 |
2 | 二进制 |
0 或 10 | 小数 |
[in, out] String
指向接收 Value 字符串表示形式的UNICODE_STRING 结构的指针。 由 String缓冲区指定的缓冲区必须足够大才能保存结果。
返回值
RtlIntegerToUnicodeString 返回 NTSTATUS 值。 可能的返回值包括:
返回代码 | 说明 |
---|---|
|
例程已成功将 Value 转换为 Unicode 字符串。 |
|
值 太大,无法转换,或者 UNICODE_STRING 结构太小,无法保存结果。 |
|
指定的基本代码无效。 唯一有效的值为 0、2、8、10 和 16。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 从 Windows 2000 开始可用。 |
目标平台 | 通用 |
标头 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h、Wudfwdm.h) |
Library | NtosKrnl.lib |
DLL | NtosKrnl.exe (内核模式) ;Ntdll.dll (用户模式) |
IRQL | PASSIVE_LEVEL |