RtlUnicodeStringToAnsiString-Funktion (winternl.h)

Artikel
03/13/2024

Konvertiert die angegebene Unicode-Quellzeichenfolge in eine ANSI-Zeichenfolge.

Syntax

NTSTATUS RtlUnicodeStringToAnsiString(
  [in, out] PANSI_STRING     DestinationString,
  [in]      PCUNICODE_STRING SourceString,
  [in]      BOOLEAN          AllocateDestinationString
);

Parameter

[in, out] DestinationString

Ein Zeiger auf eine ANSI_STRING-Struktur , die die konvertierte ANSI-Zeichenfolge enthält. Wenn AllocateDestinationStringAUF TRUE festgelegt ist, weist 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

Die UNICODE_STRING Struktur, die die Quellzeichenfolge enthält, die in ANSI konvertiert werden soll.

[in] AllocateDestinationString

Steuert die Zuordnung des Pufferbereichs für die DestinationString.

true

Pufferspeicherplatz wird für DestinationString zugeordnet. Wenn dieser Wert auf TRUE festgelegt ist, muss die Zuordnung des Puffers mithilfe von RtlFreeAnsiString aufgehoben werden.

false

Pufferspeicherplatz wird für DestinationString nicht zugewiesen.

Rückgabewert

Die verschiedenen NTSTATUS-Werte werden in NTSTATUS definiert. H, das mit dem DDK verteilt wird.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Unicode-Zeichenfolge wurde in ANSI konvertiert. Andernfalls wurde kein Speicher zugewiesen, und es wurde keine Konvertierung durchgeführt.

Hinweise

Die Übersetzung erfolgt in Bezug auf die aktuellen Gebietsschemainformationen des Systems.

Da für diese Funktion keine Importbibliothek vorhanden ist, müssen Sie GetProcAddress verwenden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winternl.h
Bibliothek	ntdll.lib
DLL	ntdll.dll; NtosKrnl.exe

Freigeben über