Funzione RtlUnicodeToMultiByteSize (ntifs.h)

Articolo
02/29/2024

La routine RtlUnicodeToMultiByteSize determina il numero di byte necessari per archiviare la conversione multibyte per la stringa Unicode specificata. Si presuppone che la traduzione usi la tabella codici ANSI del sistema corrente (ACP).

Sintassi

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

Parametri

[out] BytesInMultiByteString

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

[in] UnicodeString

Puntatore alla stringa Unicode per cui deve essere calcolata la lunghezza multibyte.

[in] BytesInUnicodeString

Lunghezza, in byte, della stringa di origine.

Valore restituito

RtlUnicodeToMultiByteSize restituisce STATUS_SUCCESS.

Commenti

RtlUnicodeToMultiByteSize può essere chiamato per determinare la quantità di memoria da allocare o eventualmente il valore da specificare per MaxBytesInMultiByteString, prima di tradurre una stringa Unicode in ANSI con RtlUnicodeToMultiByteN o RtlUpcaseUnicodeToMultiByteN. Il valore restituito non include spazio per un terminatore NULL per la stringa ANSI.

Come RtlUnicodeToMultiByteN, RtlUnicodeToMultiByteSize 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).