Funzione RtlMultiByteToUnicodeSize (ntifs.h)

  • Articolo

La routine RtlMultiByteToUnicodeSize determina il numero di byte necessari per archiviare la traduzione Unicode per la stringa di origine specificata. Si presuppone che la traduzione usi la tabella codici ANSI del sistema corrente (ACP). La stringa di origine non è necessariamente da un set di caratteri multibyte.

Sintassi

NTSYSAPI NTSTATUS RtlMultiByteToUnicodeSize(
  [out] PULONG     BytesInUnicodeString,
  [in]  const CHAR *MultiByteString,
  [in]  ULONG      BytesInMultiByteString
);

Parametri

[out] BytesInUnicodeString

Puntatore a una variabile allocata dal chiamante che riceve il numero di byte necessari per archiviare la stringa tradotta.

[in] MultiByteString

Puntatore alla stringa di origine per cui è necessario calcolare la lunghezza Unicode.

[in] BytesInMultiByteString

Lunghezza, in byte, della stringa di origine.

Valore restituito

RtlMultiByteToUnicodeSize restituisce STATUS_SUCCESS.

Commenti

RtlMultiByteToUnicodeSize può essere chiamato per determinare la quantità di memoria da allocare, o eventualmente, il valore da specificare per MaxBytesInUnicodeString, prima di tradurre una stringa multibyte in Unicode con RtlMultiByteToUnicodeN. Il valore restituito non include spazio per un terminatore NULL per la stringa Unicode.

Come RtlMultiByteToUnicodeN, RtlMultiByteToUnicodeSize supporta solo i caratteri Unicode precomposti mappati alla tabella codici ANSI del sistema corrente installata all'avvio del sistema.

Per informazioni sulle altre routine di gestione delle stringhe, vedere Routine RTL (Run-Time Library).

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Intestazione ntifs.h (include Ntifs.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

Vedi anche

RtlMultiByteToUnicodeN

RtlUnicodeToMultiByteSize