RtlUnicodeStringToOemString-Funktion (ntifs.h)

Artikel
02/07/2025

Die RtlUnicodeStringToOemString Routine übersetzt eine bestimmte Unicode-Quellzeichenfolge in eine OEM-Zeichenfolge mithilfe der aktuellen System-OEM-Codeseite.

Syntax

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

Parameter

DestinationString

Zeigen Sie auf einen vom Aufrufer zugewiesenen Puffer, um die OEM-Zeichenfolge zu empfangen. Wenn AllocateDestinationStringFALSEist, muss der Aufrufer auch einen Puffer für das Buffer Member von DestinationString- zuweisen, um die OEM-Daten aufzunehmen. Wenn AllocateDestinationStringTRUEist, RtlUnicodeStringToOemString einen Puffer groß genug zuordnet, um die Zeichenfolge zu halten, übergibt einen Zeiger in Bufferund aktualisiert die Länge und die maximale Längenmember von DestinationString entsprechend.

[in] SourceString

Zeigen Sie auf die zu übersetzende Unicode-Zeichenfolge.

[in] AllocateDestinationString

Wenn RtlUnicodeStringToOemString- den Pufferbereich für die DestinationString-FALSE auf TRUE festgelegt. Wenn dieser Parameter TRUEist, ist der Aufrufer dafür verantwortlich, den Puffer freizuweisen, wenn er nicht mehr benötigt wird, indem RtlFreeOemStringaufgerufen wird.

Rückgabewert

RtlUnicodeStringToOemString gibt STATUS_SUCCESS zurück, wenn die Zeichenfolge bei DestinationString- übersetzt wird. Andernfalls wurde kein Speicher zugewiesen, und es wurde keine Konvertierung ausgeführt.

Bemerkungen

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

RtlUnicodeStringToOemString ändert die Quellzeichenfolge nicht. Sie gibt eine NULL-gekündigte OEM-Zeichenfolge zurück.

Informationen zu anderen Zeichenfolgenbehandlungsroutinen finden Sie unter Run-Time Library (RTL)-Routinen.