RtlIntegerToUnicodeString 関数 (wdm.h)
RtlIntegerToUnicodeString ルーチンは、符号なし整数値を、指定したベースの 1 つ以上の 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 | 16 進数 |
8 | 8 進変換 |
2 | Binary |
0 または 10 | Decimal |
[in, out] String
Value の文字列表現を受け取るUNICODE_STRING構造体へのポインター。 [文字列のバッファー] で指定されるバッファーは、結果を保持するのに十分な大きさである必要があります。
戻り値
RtlIntegerToUnicodeString は NTSTATUS 値を返します。 可能な戻り値は次のとおりです。
リターン コード | 説明 |
---|---|
|
ルーチンが Value を Unicode 文字列に正常に変換しました。 |
|
値 が大きすぎて変換が行えないか、 UNICODE_STRING 構造体が小さすぎて結果を保持できなくなる。 |
|
指定したコード ベースが無効です。 有効な値は、0、2、8、10、16 のみです。 |
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 以降で使用できます。 |
対象プラットフォーム | ユニバーサル |
Header | wdm.h (Wdm.h、Ntddk.h、Ntifs.h、Wudfwdm.h を含む) |
Library | NtosKrnl.lib |
[DLL] | NtosKrnl.exe (カーネル モード);Ntdll.dll (ユーザー モード) |
IRQL | PASSIVE_LEVEL |