Freigeben über


RtlUpcaseUnicodeString-Funktion (ntddk.h)

Die RtlUpcaseUnicodeString-Routine konvertiert eine Kopie der Quellzeichenfolge in Großbuchstaben und schreibt die konvertierte Zeichenfolge in den Zielpuffer.

Syntax

NTSYSAPI NTSTATUS RtlUpcaseUnicodeString(
  [in, out] PUNICODE_STRING  DestinationString,
  [in]      PCUNICODE_STRING SourceString,
  [in]      BOOLEAN          AllocateDestinationString
);

Parameter

[in, out] DestinationString

Zeiger auf einen vom Aufrufer zugewiesenen Puffer für die konvertierte Unicode-Zeichenfolge.

[in] SourceString

Zeiger auf die Unicode-Quellzeichenfolge, die in Großbuchstaben konvertiert werden soll.

[in] AllocateDestinationString

Gibt an, ob RtlUpcaseUnicodeString den Pufferbereich für destinationString zuordnen soll. Wenn dies der Fall ist, muss die Zuordnung des Puffers aufgehoben werden, indem RtlFreeUnicodeString aufgerufen wird.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt RtlUpcaseUnicodeString STATUS_SUCCESS zurück. Andernfalls wurde kein Speicher zugewiesen, und es wurde keine Konvertierung durchgeführt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar ab Windows 2000.
Zielplattform Universell
Header ntddk.h (include Ntddk.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe (Kernelmodus); Ntdll.dll (Benutzermodus)
IRQL <= APC_LEVEL

Weitere Informationen

RtlFreeUnicodeString

RtlUpcaseUnicodeChar