RtlUpcaseUnicodeToMultiByteN-Funktion (ntifs.h)

Artikel
02/07/2025

Die RtlUpcaseUnicodeToMultiByteN Routine übersetzt die angegebene Unicode-Zeichenfolge in eine neue Zeichenfolge in Großbuchstaben, wobei die aktuelle System-ANSI-Codeseite (ACP) verwendet wird. Die übersetzte Zeichenfolge stammt nicht unbedingt aus einem Multibyte-Zeichensatz.

Syntax

NTSYSAPI NTSTATUS RtlUpcaseUnicodeToMultiByteN(
  [out]           PCHAR  MultiByteString,
  [in]            ULONG  MaxBytesInMultiByteString,
  [out, optional] PULONG BytesInMultiByteString,
  [in]            PCWCH  UnicodeString,
  [in]            ULONG  BytesInUnicodeString
);

Parameter

[out] MultiByteString

Zeigen Sie auf einen vom Aufrufer zugewiesenen Puffer, um die übersetzte Zeichenfolge zu empfangen.

[in] MaxBytesInMultiByteString

Maximale Anzahl von Bytes, die bei MultiByteString-geschrieben werden sollen. Wenn dieser Wert bewirkt, dass die übersetzte Zeichenfolge abgeschnitten wird, gibt RtlUpcaseUnicodeToMultiByteN keinen Fehlerstatus zurück.

[out, optional] BytesInMultiByteString

Zeigen Sie auf eine vom Aufrufer zugewiesene Variable, die die Länge der übersetzten Zeichenfolge in Bytes empfängt. Dieser Parameter kann NULL-sein.

[in] UnicodeString

Zeigen Sie auf die zu übersetzende Unicode-Quellzeichenfolge.

[in] BytesInUnicodeString

Größe der Zeichenfolge in Bytes bei UnicodeString-.

Rückgabewert

RtlUpcaseUnicodeToMultiByteN gibt STATUS_SUCCESS zurück.

Bemerkungen

RtlUpcaseUnicodeToMultiByteN übersetzt die angegebene Unicode-Zeichenfolge mithilfe der aktuellen System-ANSI-Codeseite, die zur Systemstartzeit installiert ist, und konvertiert die übersetzte Zeichenfolge in Großbuchstaben.

Diese Routine ändert die Quellzeichenfolge nicht. Es gibt eine NULL-beendete ANSI-Zeichenfolge zurück, wenn die angegebene BytesInUnicodeString- einen NULL-Terminator enthalten und wenn die angegebene MaxBytesInMultiByteString- keine Abkürzung verursacht hat.

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