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 (ACP) di sistema corrente. 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 calcolare la lunghezza Unicode.
[in] BytesInMultiByteString
Lunghezza, in byte, della stringa di origine.
Valore restituito
RtlMultiByteToUnicodeSize restituisce STATUS_SUCCESS.
Osservazioni
RtlMultiByteToUnicodeSize può essere chiamato per determinare la quantità di memoria da allocare o eventualmente il valore da specificare per MaxBytesInUnicodeString, prima di convertire una stringa multibyte in Unicode con RtlMultiByteToUnicodeN. Il valore restituito non include spazio per un carattere di terminazione NULL per la stringa Unicode.
Come RtlMultiByteToUnicodeN, RtlMultiByteToUnicodeSize supporta solo i caratteri Unicode precompisi mappati alla tabella codici ANSI di sistema corrente installata all'avvio del sistema.
Per informazioni su altre routine di gestione delle stringhe, vedere Routine RTL (Run-Time Library).
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| intestazione | ntifs.h (include Ntifs.h) |
| libreria | NtosKrnl.lib |
| dll | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |