RtlOemStringToUnicodeString-Funktion (ntifs.h)

Artikel
02/07/2025

Die RtlOemStringToUnicodeString Routine übersetzt eine bestimmte Quellzeichenfolge in eine mit Null beendete Unicode-Zeichenfolge mithilfe der aktuellen SYSTEM-OEM-Codeseite.

Syntax

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

Parameter

DestinationString

Zeigen Sie auf einen vom Aufrufer zugewiesenen Puffer, um die übersetzte Zeichenfolge zu empfangen. Wenn AllocateDestinationStringFALSE-ist, muss der Aufrufer auch einen Puffer für das Buffer Member von DestinationString- zuweisen, um die mit Null beendete Unicode-Zeichenfolge zu enthalten. Wenn AllocateDestinationStringTRUEist, RtlOemStringToUnicodeString einen Puffer groß genug zuordnet, um die Zeichenfolge zu halten, übergibt einen Zeiger in Buffer-und aktualisiert die Länge und die maximale Längenmember von DestinationString entsprechend.

[in] SourceString

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

[in] AllocateDestinationString

Auf TRUE festgelegt, wenn RtlOemStringToUnicodeString- den Pufferbereich für die DestinationString-FALSE- zuordnen soll. Wenn dieser Parameter TRUEist, ist der Aufrufer dafür verantwortlich, den Puffer freizuweisen, wenn er nicht mehr benötigt wird, indem RtlFreeUnicodeStringaufgerufen 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.

Bemerkungen

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

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

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