RtlAnsiStringToUnicodeString-Funktion (winternl.h)

Artikel
08/27/2023

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

Syntax

NTSTATUS RtlAnsiStringToUnicodeString(
  [in, out] PUNICODE_STRING DestinationString,
  [in]      PCANSI_STRING   SourceString,
  [in]      BOOLEAN         AllocateDestinationString
);

Parameter

[in, out] DestinationString

Ein Zeiger auf eine UNICODE_STRING-Struktur , die die konvertierte Unicode-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

Ein Zeiger auf die ANSI_STRING-Struktur , die die ANSI-Zeichenfolge enthält, die in Unicode konvertiert werden soll.

[in] AllocateDestinationString

Steuert die Zuordnung des Pufferspeichers für die Zielzeichenfolge.

true

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

false

Pufferspeicherplatz wird für DestinationString nicht zugewiesen.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die ANSI-Zeichenfolge wurde in Unicode konvertiert. Bei Einem Fehler ordnet die Routine keinen Arbeitsspeicher zu.

Hinweise

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

Wenn der Aufrufer AllocateDestinationString auf TRUE festlegt, ersetzt die Routine den Buffer-Member von DestinationString durch einen Zeiger auf den zugeordneten Puffer. Der alte Wert kann auch dann überschrieben werden, wenn die Routine einen Fehler status Code zurückgibt.

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

Anforderungen


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

Freigeben über