Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
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 (Kernelmodus); Ntdll.dll (Benutzermodus) |
| IRQL | PASSIVE_LEVEL |