RtlUpcaseUnicodeStringToOemString-Funktion (ntifs.h)

Artikel
02/26/2024

Die RtlUpcaseUnicodeStringToOemString-Routine übersetzt eine bestimmte Unicode-Quellzeichenfolge mithilfe der aktuellen System-OEM-Codepage in eine OEM-Zeichenfolge in Großbuchstaben.

Syntax

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

Parameter

DestinationString

Zeiger auf einen vom Aufrufer zugewiesenen Puffer, um die gezählte OEM-Zeichenfolge zu empfangen. Wenn AllocateDestinationStringfalse 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 RtlUpcaseUnicodeStringToOemString einen Puffer zu, der groß genug ist, um die Zeichenfolge zu halten, übergibt einen Zeiger darauf in Buffer und aktualisiert die Länge und die maximale Länge von DestinationString entsprechend.

[in] SourceString

Zeiger auf die zu übersetzende Unicode-Zeichenfolge.

[in] AllocateDestinationString

Legen Sie auf TRUE fest, wenn RtlUpcaseUnicodeStringToOemString den Pufferraum für destinationString zuordnen soll, andernfalls FALSE . Wenn dieser Parameter TRUE ist, ist der Aufrufer für das Freigeben des Puffers verantwortlich, wenn er nicht mehr benötigt wird, indem er RtlFreeOemString aufruft.

Rückgabewert

RtlUpcaseUnicodeStringToOemString gibt STATUS_SUCCESS zurück, wenn die Zeichenfolge bei DestinationString übersetzt wird. Andernfalls wurde kein Speicher zugewiesen, noch wurde eine Konvertierung durchgeführt.

Hinweise

RtlUpcaseUnicodeStringToOemString übersetzt die angegebene Quellzeichenfolge mithilfe der OEM-Codepage, die zur Systemstartzeit als aktuelle Systemcodepage installiert wurde, und konvertiert die OEM-Zeichenfolge in Großbuchstaben.

Diese Routine kann ein Standardzeichen in der Zielzeichenfolge durch alle Quellzeichenfolgenzeichen ersetzen, die nicht der aktuellen Codepage zugeordnet werden können, und dann STATUS_SUCCESS zurückgeben.

Diese Routine ändert die Quellzeichenfolge nicht. Es gibt eine NULL-beendete OEM-Zeichenfolge zurück.

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