RtlUpcaseUnicodeStringToCountedOemString-Funktion (ntifs.h)

Artikel
02/07/2025

Die RtlUpcaseUnicodeStringToCountedOemString Routine übersetzt eine angegebene Unicode-Quellzeichenfolge in eine gezählte OEM-Zeichenfolge in Großbuchstaben mithilfe der aktuellen System-OEM-Codeseite.

Syntax

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

Parameter

DestinationString

Zeigen Sie auf einen vom Aufrufer zugewiesenen Puffer, um die gezählte OEM-Zeichenfolge zu erhalten. Wenn AllocateDestinationString- FALSCH ist, muss der Aufrufer auch einen Puffer für das Buffer Member von DestinationString- zuweisen, um die OEM-Daten zu enthalten. Wenn AllocateDestinationString- WAHR ist, RtlUpcaseUnicodeStringToCountedOemString einen Puffer groß genug zuordnet, um die Zeichenfolge zu halten, übergibt einen Zeiger in Bufferund aktualisiert die Länge und die maximale Längenmember von DestinationString entsprechend.

[in] SourceString

Zeigen Sie auf die zu übersetzende Unicode-Zeichenfolge.

[in] AllocateDestinationString

Wird auf TRUE festgelegt, wenn RtlUpcaseUnicodeStringToCountedOemString den Pufferspeicher für die DestinationString-zuordnen soll, andernfalls FALSE. Wenn dieser Parameter TRUE ist, ist der Aufrufer dafür verantwortlich, den Puffer freizuweisen, wenn er nicht mehr benötigt wird, indem RtlFreeOemStringaufgerufen 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 wird STATUS_UNMAPPABLE_CHARACTER zurückgegeben, wenn es kein Zeichen im angegebenen SourceString-übersetzen kann.

Bemerkungen

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

Um eine Zuordnung mit der besten Übereinstimmung für alle Sonderzeichen wie z. B. ein Copyrightzeichen in der angegebenen Quellzeichenfolge zu finden, RtlUpcaseUnicodeStringToCountedOemString die folgenden Vorgänge aus:

Übersetzt eine Kopie der Unicode-Zeichenfolge bei SourceString- in eine OEM-Zeichenfolge.
Übersetzt die OEM-Zeichenfolge wieder 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 an DestinationString-

Diese Routine ändert die Quellzeichenfolge nicht.

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