Funzione RtlMultiByteToUnicodeSize (ntifs.h)
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 |