RtlIntegerToUnicodeString 函式 (wdm.h)

  • 發行項

RtlIntegerToUnicodeString 例程會將不帶正負號的整數值轉換成指定基底中一或多個 Unicode 字元的 Null 終止字元串。

語法

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 Decimal

[in, out] String

接收 Value 字串表示之UNICODE_STRING結構的指標。 字串緩衝區指定的緩衝區必須夠大，才能保存結果。

傳回值

RtlIntegerToUnicodeString 會傳回 NTSTATUS 值。 可能的傳回值包括：

傳回碼 Description
STATUS_SUCCESS
 例程已成功將 Value 轉換成 Unicode 字串。
STATUS_BUFFER_OVERFLOW
 值 太大而無法轉換，或 UNICODE_STRING 結構太小而無法保存結果。
STATUS_INVALID_PARAMETER
 指定的程式代碼基底無效。 唯一的有效值為 0、2、8、10 和 16。

規格需求

需求 值
最低支援的用戶端 從 Windows 2000 開始提供。
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h、Wudfwdm.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe (核心模式) ;Ntdll.dll (使用者模式)
IRQL PASSIVE_LEVEL

另請參閱

RtlAppendUnicodeStringToString

RtlUnicodeStringToInteger

UNICODE_STRING