RtlUpcaseUnicodeStringToCountedOemString-Funktion (ntifs.h)

Artikel
02/27/2024

Die RtlUpcaseUnicodeStringToCountedOemString-Routine übersetzt eine angegebene Unicode-Quellzeichenfolge mithilfe der aktuellen OEM-Codepage des Aktuellen Systems in eine gezählte OEM-Zeichenfolge in Großbuchstaben.

Syntax

NTSYSAPI NTSTATUS RtlUpcaseUnicodeStringToCountedOemString(
       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 AllocateDestinationString auf FALSE festgelegt ist, muss der Aufrufer auch einen Puffer für den Buffer-Member von DestinationString zuweisen, um die OEM-Daten zu enthalten. Wenn AllocateDestinationString TRUE ist, weist RtlUpcaseUnicodeStringToCountedOemString 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 zu übersetzende Unicode-Zeichenfolge.

[in] AllocateDestinationString

Legen Sie diesen Wert auf TRUE fest, wenn RtlUpcaseUnicodeStringToCountedOemString 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 RtlFreeOemString aufgerufen wird.

Rückgabewert

RtlUpcaseUnicodeStringToCountedOemString gibt STATUS_SUCCESS zurück, wenn eine übersetzte Zeichenfolge bei DestinationString zurückgegeben wird. Andernfalls wurde kein Speicher zugewiesen, noch wurde eine Konvertierung durchgeführt. Es gibt STATUS_UNMAPPABLE_CHARACTER zurück, wenn ein Zeichen im angegebenen SourceString nicht übersetzt werden kann.

Hinweise

RtlUpcaseUnicodeStringToCountedOemString gibt eine Zeichenfolge zurück, die nicht null-beendet ist. Es übersetzt die angegebene Quellzeichenfolge mithilfe der OEM-Codepage, die zum Systemstartzeit als aktuelle Systemcodepage installiert wurde, und konvertiert die übersetzte Zeichenfolge in Großbuchstaben.

RtlUpcaseUnicodeStringToCountedOemString führt die folgenden Vorgänge aus, um in der angegebenen Quellzeichenfolge eine Zuordnung mit den besten Übereinstimmungen für Sonderzeichen zu finden, z. B. ein Copyrightzeichen:

Übersetzt eine Kopie der Unicode-Zeichenfolge bei SourceString in eine OEM-Zeichenfolge.
Übersetzt die OEM-Zeichenfolge zurück in Unicode.
Konvertiert diese neue Unicode-Zeichenfolge in Großbuchstaben.
Übersetzt die Unicode-Zeichenfolge in Großbuchstaben in eine gezählte OEM-Zeichenfolge und gibt sie unter DestinationString zurück.

Diese Routine ändert die Quellzeichenfolge nicht.

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