RtlUnicodeToMultiByteSize-Funktion (ntifs.h)

Artikel
02/07/2025

Die RtlUnicodeToMultiByteSize Routine bestimmt die Anzahl der Bytes, die zum Speichern der Multibyte-Übersetzung für die angegebene Unicode-Zeichenfolge erforderlich sind. Die Übersetzung wird davon ausgegangen, dass die aktuelle System-ANSI-Codepage (ACP) verwendet wird.

Syntax

NTSYSAPI NTSTATUS RtlUnicodeToMultiByteSize(
  [out] PULONG BytesInMultiByteString,
  [in]  PCWCH  UnicodeString,
  [in]  ULONG  BytesInUnicodeString
);

Parameter

[out] BytesInMultiByteString

Zeigen Sie auf eine vom Aufrufer zugewiesene Variable, die die Anzahl der Bytes empfängt, die zum Speichern der übersetzten Zeichenfolge erforderlich sind.

[in] UnicodeString

Zeigen Sie auf die Unicode-Zeichenfolge, für die die Multibytelänge berechnet werden soll.

[in] BytesInUnicodeString

Länge der Quellzeichenfolge in Byte.

Rückgabewert

RtlUnicodeToMultiByteSize gibt STATUS_SUCCESS zurück.

Bemerkungen

RtlUnicodeToMultiByteSize- kann aufgerufen werden, um zu bestimmen, wie viel Arbeitsspeicher zugewiesen werden soll, oder möglicherweise der Wert, der für MaxBytesInMultiByteString-angegeben werden soll, bevor eine Unicode-Zeichenfolge mit RtlUnicodeToMultiByteN oder RtlUpcaseUnicodeToMultiByteNin ANSI übersetzt wird. Der zurückgegebene Wert enthält keinen Leerraum für einen NULL-Terminator für die ANSI-Zeichenfolge.

Wie RtlUnicodeToMultiByteN-unterstützt RtlUnicodeToMultiByteSize- 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.