RtlUnicodeStringToOemString-Funktion (ntifs.h)

Artikel
02/29/2024

Die RtlUnicodeStringToOemString-Routine übersetzt eine angegebene Unicode-Quellzeichenfolge mithilfe der aktuellen OEM-Codepage des Systems in eine OEM-Zeichenfolge.

Syntax

NTSYSAPI NTSTATUS RtlUnicodeStringToOemString(
       POEM_STRING      DestinationString,
  [in] PCUNICODE_STRING SourceString,
  [in] BOOLEAN          AllocateDestinationString
);

Parameter

DestinationString

Zeiger auf einen vom Aufrufer zugewiesenen Puffer, um die OEM-Zeichenfolge zu empfangen. Wenn AllocateDestinationStringauf FALSE festgelegt ist, muss der Aufrufer auch einen Puffer für den Buffer-Member von DestinationString zuweisen, um die OEM-Daten zu enthalten. Wenn AllocateDestinationStringTRUE ist, weist RtlUnicodeStringToOemString 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 zu übersetzende Unicode-Zeichenfolge.

[in] AllocateDestinationString

Legen Sie diesen Wert auf TRUE fest, wenn RtlUnicodeStringToOemString 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 RtlFreeOemString aufgerufen wird.

Rückgabewert

RtlUnicodeStringToOemString gibt STATUS_SUCCESS zurück, wenn die Zeichenfolge unter DestinationString übersetzt wird. Andernfalls wurde kein Speicher zugeordnet, und es wurde keine Konvertierung durchgeführt.

Hinweise

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

RtlUnicodeStringToOemString ändert die Quellzeichenfolge nicht. Es gibt eine OEM-Zeichenfolge mit NULL-Beendigung zurück.

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