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

Weitere Informationen

ANSI_STRING

RtlAnsiStringToUnicodeString

RtlFreeAnsiString

UNICODE_STRING