RtlIntegerToUnicodeString-Funktion (wdm.h)

Artikel
03/01/2024

Die RtlIntegerToUnicodeString-Routine konvertiert einen ganzzahligen Wert ohne Vorzeichen in eine null-endende Zeichenfolge mit mindestens einem Unicode-Zeichen in der angegebenen Basis.

Syntax

NTSYSAPI NTSTATUS RtlIntegerToUnicodeString(
  [in]           ULONG           Value,
  [in, optional] ULONG           Base,
  [in, out]      PUNICODE_STRING String
);

Parameter

[in] Value

Gibt den zu konvertierenden ULONG-Wert an.

[in, optional] Base

Gibt die Basis an, die beim Konvertieren von Value in eine Zeichenfolge verwendet werden soll. Mögliche Werte:

Wert	Basis
16	Hexadezimal
8	Oktal
2	Binary
0 oder 10	Decimal

[in, out] String

Zeiger auf eine UNICODE_STRING Struktur, die die Zeichenfolgendarstellung von Value empfängt. Der vom Puffer der Zeichenfolge angegebene Puffer muss groß genug sein, um das Ergebnis zu enthalten.

Rückgabewert

RtlIntegerToUnicodeString gibt einen NTSTATUS-Wert zurück. Mögliche Rückgabewerte sind:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Routine hat Value erfolgreich in eine Unicode-Zeichenfolge konvertiert.
STATUS_BUFFER_OVERFLOW	Der Wert ist zum Konvertieren zu groß, oder die UNICODE_STRING Struktur ist zu klein, um das Ergebnis zu speichern.
STATUS_INVALID_PARAMETER	Die angegebene Codebasis ist ungültig. Die einzigen gültigen Werte sind 0, 2, 8, 10 und 16.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 2000.
Zielplattform	Universell
Header	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe (Kernelmodus); Ntdll.dll (Benutzermodus)
IRQL	PASSIVE_LEVEL

Weitere Informationen

RtlAppendUnicodeStringToString

RtlUnicodeStringToInteger

UNICODE_STRING

Freigeben über