Freigeben über


RtlUpcaseUnicodeToMultiByteN-Funktion (ntifs.h)

Die RtlUpcaseUnicodeToMultiByteN-Routine übersetzt die angegebene Unicode-Zeichenfolge unter Verwendung der aktuellen System-ANSI-Codepage (ACP) in eine neue Großbuchstabenzeichenfolge. 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

Zeiger 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 dazu führt, dass die übersetzte Zeichenfolge abgeschnitten wird, gibt RtlUpcaseUnicodeToMultiByteN keinen Fehler status zurück.

[out, optional] BytesInMultiByteString

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

[in] UnicodeString

Zeiger auf die zu übersetzende Unicode-Quellzeichenfolge.

[in] BytesInUnicodeString

Größe der Zeichenfolge in Bytes bei UnicodeString.

Rückgabewert

RtlUpcaseUnicodeToMultiByteN gibt STATUS_SUCCESS zurück.

Hinweise

RtlUpcaseUnicodeToMultiByteN übersetzt die angegebene Unicode-Zeichenfolge mithilfe der aktuellen System-ANSI-Codepage, 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 der angegebene BytesInUnicodeString einen NULL-Abschlussator enthält und wenn der angegebene MaxBytesInMultiByteString keine Abschneidung verursacht hat.

Informationen zu anderen Zeichenfolgenbehandlungsroutinen 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

Weitere Informationen

RtlMultiByteToUnicodeN

RtlUnicodeToMultiByteN

RtlUnicodeToMultiByteSize