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 |