RtlAnsiStringToUnicodeString-Funktion (winternl.h)
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 |
---|---|
|
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 |