RtlOemStringToCountedUnicodeString-Funktion (ntifs.h)

Artikel
02/07/2025

Die RtlOemStringToCountedUnicodeString Routine übersetzt die angegebene Quellzeichenfolge mithilfe der aktuellen System-OEM-Codeseite in eine Unicode-Zeichenfolge.

Syntax

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

Parameter

DestinationString

Zeigen Sie auf einen vom Aufrufer zugewiesenen Puffer, um die übersetzte Unicode-Zeichenfolge zu empfangen. Wenn AllocateDestinationStringFALSE-ist, muss der Aufrufer auch einen Puffer für das Buffer Member DestinationString- zuweisen, um die Unicode-Daten zu enthalten. Wenn AllocateDestinationStringTRUEist, RtlOemStringToCountedUnicodeString einen Puffer groß genug zuordnet, um die Zeichenfolge zu halten, übergibt einen Zeiger darauf in Bufferund 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

Wenn "RtlOemStringToCountedUnicodeString"- 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 RtlFreeUnicodeStringaufgerufen 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.

Bemerkungen

RtlOemStringToCountedUnicodeString gibt eine übersetzte Zeichenfolge zurück, die keinen NULL-Terminator enthält. Sie übersetzt die angegebene Quellzeichenfolge mithilfe der OEM-Codeseite, die zur Startzeit als aktuelle Systemcodeseite installiert wurde.

RtlOemStringToCountedUnicodeString ändert die Quellzeichenfolge nicht.

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