RtlUnicodeToMultiByteSize-Funktion (ntifs.h)

Artikel
02/29/2024

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

Syntax

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

Parameter

[out] BytesInMultiByteString

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

[in] UnicodeString

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

[in] BytesInUnicodeString

Länge der Quellzeichenfolge in Bytes.

Rückgabewert

RtlUnicodeToMultiByteSize gibt STATUS_SUCCESS zurück.

Hinweise

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

Wie RtlUnicodeToMultiByteN unterstützt RtlUnicodeToMultiByteSize nur vorkompilierte Unicode-Zeichen, die der aktuellen System-ANSI-Codepage zugeordnet sind, die beim Systemstart installiert ist.

Informationen zu anderen Zeichenfolgenbehandlungsroutinen finden Sie unter Laufzeitbibliotheksroutinen (RTL).