RtlInt64ToUnicodeString-Funktion (wdm.h)
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 |
|---|---|
|
Die Routine hat Value erfolgreich in eine Unicode-Zeichenfolge konvertiert. |
|
Der Wert ist zum Konvertieren zu groß, oder die UNICODE_STRING Struktur ist zu klein, um das Ergebnis zu speichern. |
|
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 |