RtlUnicodeStringToAnsiString-Funktion (wdm.h)
Die RtlUnicodeStringToAnsiString-Routine konvertiert eine angegebene Unicode-Zeichenfolge in eine ANSI-Zeichenfolge.
Syntax
NTSYSAPI NTSTATUS RtlUnicodeStringToAnsiString(
[in, out] PANSI_STRING DestinationString,
[in] PCUNICODE_STRING SourceString,
[in] BOOLEAN AllocateDestinationString
);
Parameter
[in, out] DestinationString
Zeiger auf eine ANSI_STRING-Struktur , die die konvertierte ANSI-Zeichenfolge enthält. Wenn AllocateDestinationStringAUF TRUE festgelegt ist, ordnet die Routine einen neuen Puffer zu, der die Zeichenfolgendaten enthält, und aktualisiert den Buffer-Member von DestinationString so, dass er auf den neuen Puffer verweist. Andernfalls verwendet die Routine den derzeit angegebenen Puffer, um die Zeichenfolge zu enthalten.
[in] SourceString
Zeiger auf die Unicode-Quellzeichenfolge, die in ANSI konvertiert werden soll.
[in] AllocateDestinationString
TRUE , wenn diese Routine den Pufferspeicher für die DestinationString-Instanz ordnet. Wenn dies der Fall ist, muss die Zuordnung des Puffers aufgehoben werden, indem RtlFreeAnsiString aufgerufen wird.
Rückgabewert
Wenn die Konvertierung erfolgreich ist, gibt RtlUnicodeStringToAnsiString STATUS_SUCCESS zurück. Andernfalls wurde kein Speicher zugewiesen, und es wurde keine Konvertierung durchgeführt.
Hinweise
Die Übersetzung erfolgt in Übereinstimmung mit den aktuellen Systemgebietsschemainformationen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 2000. |
| Zielplattform | Universell |
| Header | wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |