RtlMultiByteToUnicodeSize-Funktion (ntifs.h)

  • Artikel

Die RtlMultiByteToUnicodeSize-Routine bestimmt die Anzahl der Bytes, die zum Speichern der Unicode-Übersetzung für die angegebene Quellzeichenfolge erforderlich sind. Es wird davon ausgegangen, dass die Übersetzung die aktuelle System-ANSI-Codepage (ACP) verwendet. 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

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

[in] MultiByteString

Zeiger auf die Quellzeichenfolge, für die die Unicode-Länge berechnet werden soll.

[in] BytesInMultiByteString

Länge der Quellzeichenfolge in Bytes.

Rückgabewert

RtlMultiByteToUnicodeSize gibt STATUS_SUCCESS zurück.

Hinweise

RtlMultiByteToUnicodeSize kann aufgerufen werden, um zu bestimmen, wie viel Arbeitsspeicher oder möglicherweise der Wert für MaxBytesInUnicodeString zugewiesen werden soll, bevor eine Multibytezeichenfolge mit RtlMultiByteToUnicodeN in Unicode übersetzt wird. Der zurückgegebene Wert enthält keinen Leerraum für einen NULL-Abschlussator für die Unicode-Zeichenfolge.

Wie RtlMultiByteToUnicodeN unterstützt RtlMultiByteToUnicodeSize 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).

Anforderungen

Anforderung Wert
Zielplattform Universell
Header ntifs.h (include Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

Weitere Informationen

RtlMultiByteToUnicodeN

RtlUnicodeToMultiByteSize