RtlMultiByteToUnicodeSize-Funktion (ntifs.h)
Die RtlMultiByteToUnicodeSize Routine bestimmt die Anzahl der Bytes, die zum Speichern der Unicode-Übersetzung für die angegebene Quellzeichenfolge erforderlich sind. Die Übersetzung wird davon ausgegangen, dass die aktuelle System-ANSI-Codepage (ACP) verwendet wird. Die Quellzeichenfolge stammt nicht unbedingt aus einem Multibyte-Zeichensatz.
Syntax
NTSYSAPI NTSTATUS RtlMultiByteToUnicodeSize(
[out] PULONG BytesInUnicodeString,
[in] const CHAR *MultiByteString,
[in] ULONG BytesInMultiByteString
);
Parameter
[out] BytesInUnicodeString
Zeigen Sie auf eine vom Aufrufer zugewiesene Variable, die die Anzahl der Bytes empfängt, die zum Speichern der übersetzten Zeichenfolge erforderlich sind.
[in] MultiByteString
Zeigen Sie auf die Quellzeichenfolge, für die die Unicode-Länge berechnet werden soll.
[in] BytesInMultiByteString
Länge der Quellzeichenfolge in Byte.
Rückgabewert
RtlMultiByteToUnicodeSize gibt STATUS_SUCCESS zurück.
Bemerkungen
RtlMultiByteToUnicodeSize- kann aufgerufen werden, um zu bestimmen, wie viel Arbeitsspeicher zugeordnet werden soll, oder ggf. der Wert, der für MaxBytesInUnicodeStringangegeben werden soll, bevor eine Multibyte-Zeichenfolge in Unicode mit RtlMultiByteToUnicodeNübersetzt wird. Der zurückgegebene Wert enthält keinen Leerraum für einen NULL-Terminator für die Unicode-Zeichenfolge.
Wie RtlMultiByteToUnicodeN-unterstützt RtlMultiByteToUnicodeSize nur vorkompilierte Unicode-Zeichen, die der aktuellen System-ANSI-Codeseite zugeordnet sind, die beim Systemstart installiert sind.
Informationen zu anderen Zeichenfolgenbehandlungsroutinen finden Sie unter Run-Time Library (RTL)-Routinen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Header- | ntifs.h (einschließlich Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | < DISPATCH_LEVEL |