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 值。 可能的返回值包括：

返回代码 说明
STATUS_SUCCESS
 例程已成功将 Value 转换为 Unicode 字符串。
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)
Library NtosKrnl.lib
DLL NtosKrnl.exe (内核模式) ;Ntdll.dll (用户模式)
IRQL PASSIVE_LEVEL

另请参阅

RtlAppendUnicodeStringToString

RtlUnicodeStringToInteger

UNICODE_STRING