RtlIntPtrToUnicodeString-Makro (wdm.h)

Die RtlIntPtrToUnicodeString-Routine konvertiert einen angegebenen ULONG_PTR-Wert in eine Unicode-Zeichenfolge, die den Wert in einer angegebenen Basis darstellt.

Syntax

void RtlIntPtrToUnicodeString(
  [in]            Value,
  [in, optional]  Base,
  [in, out]       String
);

Parameter

[in] Value

Gibt den zu konvertierenden ULONG_PTR 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 von String angegebene Puffer muss groß genug sein, um das Ergebnis zu halten.

Rückgabewert

Keine

Bemerkungen

RtlIntPtrToUnicodeString 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 zu groß zum Konvertieren, 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	Desktop
Kopfzeile	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Weitere Informationen

RtlAppendUnicodeStringToString

RtlIntegerToUnicodeString

RtlUnicodeStringToInteger

UNICODE_STRING