RtlUpcaseUnicodeStringToCountedOemString-Funktion (ntifs.h)
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.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform- | Universal |
Header- | ntifs.h (einschließlich Ntifs.h) |
Library | NtosKrnl.lib |
DLL- | NtosKrnl.exe |
IRQL- | < DISPATCH_LEVEL |
Siehe auch
RtlOemStringToCountedUnicodeString
RtlUnicodeStringToCountedOemString