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 |