RtlOemStringToCountedUnicodeString-Funktion (ntifs.h)

Artikel
08/07/2023

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

Syntax

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

Parameter

DestinationString

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

Wenn der Vorgang erfolgreich ist, gibt RtlOemStringToCountedUnicodeString STATUS_SUCCESS zurück. Andernfalls wurde kein Speicher zugewiesen, und es wurde keine Konvertierung durchgeführt.

Hinweise

RtlOemStringToCountedUnicodeString gibt eine übersetzte Zeichenfolge zurück, die keinen NULL-Abschlusszeichen enthält. Die angegebene Quellzeichenfolge wird mithilfe der OEM-Codepage übersetzt, die zum Startzeitpunkt als aktuelle Systemcodepage installiert wurde.

RtlOemStringToCountedUnicodeString ändert die Quellzeichenfolge nicht.

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