Freigeben über

RtlInt64ToUnicodeString-Funktion (wdm.h)

  • Artikel

Die RtlInt64ToUnicodeString-Routine konvertiert einen angegebenen 64-Bit-Ganzzahlwert ohne Vorzeichen in eine Unicode-Zeichenfolge, die den Wert in einer angegebenen Basis darstellt.

Syntax

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

Parameter

[in] Value

Gibt den zu konvertierenden ULONGLONG-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 die 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

RtlInt64ToUnicodeString 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
IRQL PASSIVE_LEVEL

Weitere Informationen

RtlAppendUnicodeStringToString

RtlUnicodeStringToInteger

UNICODE_STRING