RtlOemStringToUnicodeString-Funktion (ntifs.h)

Artikel
02/29/2024

Die RtlOemStringToUnicodeString-Routine übersetzt eine angegebene Quellzeichenfolge mithilfe der aktuellen OEM-Codepage des Systems in eine unicode-Zeichenfolge mit NULL-Terminierung.

Syntax

NTSYSAPI NTSTATUS RtlOemStringToUnicodeString(
       PUNICODE_STRING DestinationString,
  [in] PCOEM_STRING    SourceString,
  [in] BOOLEAN         AllocateDestinationString
);

Parameter

DestinationString

Zeiger auf einen vom Aufrufer zugewiesenen Puffer, um die übersetzte Zeichenfolge zu empfangen. Wenn AllocateDestinationStringauf FALSE festgelegt ist, muss der Aufrufer auch einen Puffer für den Buffer-Member von DestinationString zuweisen, um die mit NULL beendete Unicode-Zeichenfolge zu enthalten. Wenn AllocateDestinationStringTRUE ist, weist RtlOemStringToUnicodeString einen Puffer zu, der groß genug ist, um die Zeichenfolge zu halten, übergibt einen Zeiger darauf in Buffer und aktualisiert die Länge und maximale Länge von DestinationString entsprechend.

[in] SourceString

Zeiger auf die OEM-Zeichenfolge, die in Unicode übersetzt werden soll.

[in] AllocateDestinationString

Legen Sie diesen Wert auf TRUE fest, wenn RtlOemStringToUnicodeString den Pufferbereich für destinationString zuordnen soll, andernfalls FALSE . Wenn dieser Parameter TRUE ist, ist der Aufrufer dafür verantwortlich, den Puffer frei zu geben, wenn er nicht mehr benötigt wird, indem RtlFreeUnicodeString aufgerufen wird.

Rückgabewert

RtlOemStringToUnicodeString gibt STATUS_SUCCESS zurück, wenn eine übersetzte Zeichenfolge bei DestinationString zurückgegeben wird. Andernfalls wurde kein Speicher zugewiesen, und es wurde keine Konvertierung durchgeführt.

Hinweise

RtlOemStringToUnicodeString übersetzt die angegebene Quellzeichenfolge mithilfe der OEM-Codepage, die zur Systemstartzeit als aktuelle Systemcodepage installiert wurde.

Diese Routine ändert die Quellzeichenfolge nicht. Sie gibt eine MIT NULL beendete Unicode-Zeichenfolge zurück.

Informationen zu anderen Zeichenfolgenverarbeitungsroutinen finden Sie unter Laufzeitbibliotheksroutinen (RTL).