Freigeben über

RtlIntegerToUnicodeString-Funktion (wdm.h)

  • Artikel

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