RtlDowncaseUnicodeString-Funktion (ntifs.h)
Die RtlDowncaseUnicodeString-Routine konvertiert die angegebene Unicode-Quellzeichenfolge in Kleinbuchstaben. Die Übersetzung entspricht den aktuellen Gebietsschemainformationen des Systems.
Syntax
NTSYSAPI NTSTATUS RtlDowncaseUnicodeString(
PUNICODE_STRING DestinationString,
[in] PCUNICODE_STRING SourceString,
[in] BOOLEAN AllocateDestinationString
);
Parameter
DestinationString
Zeiger auf einen vom Aufrufer zugewiesenen Puffer, um die konvertierte Unicode-Zeichenfolge zu empfangen. Wenn AllocateDestinationStringauf FALSE festgelegt ist, muss der Aufrufer auch einen Puffer für den Buffer-Member von DestinationString zuweisen, um die Unicode-Daten zu enthalten. Wenn AllocateDestinationStringTRUE ist, weist RtlDowncaseUnicodeString 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 Unicode-Quellzeichenfolge, die in Kleinbuchstaben konvertiert werden soll.
[in] AllocateDestinationString
Legen Sie diesen Wert auf TRUE fest, wenn RtlDowncaseUnicodeString den Pufferraum 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 RtlFreeUnicodeString aufgerufen wird.
Rückgabewert
Wenn der Vorgang erfolgreich ist, gibt RtlDowncaseUnicodeString STATUS_SUCCESS zurück. Andernfalls wurde kein Speicher zugewiesen, und es wurde keine Konvertierung durchgeführt.
Hinweise
Wenn der Aufrufer AllocateDestinationString auf TRUE festlegt, ersetzt RtlDowncaseUnicodeString den Buffer-Member von DestinationString durch einen Zeiger auf den zuzuordnenden Puffer. Der alte Wert kann auch dann überschrieben werden, wenn die Routine einen Fehler status Code zurückgibt.
RtlDowncaseUnicodeString ändert die Quellzeichenfolge nicht.
Informationen zu anderen Zeichenfolgenverarbeitungsroutinen finden Sie unter Laufzeitbibliotheksroutinen (RTL).
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | ntifs.h (include Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |