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

Weitere Informationen

ANSI_STRING

RtlAnsiStringToUnicodeString

RtlFreeAnsiString

UNICODE_STRING