Funzione RtlUnicodeToMultiByteSize (winternl.h)

Articolo
02/01/2024

Determina il numero di byte necessari per rappresentare una stringa Unicode come stringa ANSI.

Sintassi

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

Parametri

[out] BytesInMultiByteString

Restituisce il numero di byte per l'equivalente ANSI della stringa Unicode a cui fa riferimento UnicodeString. Questo numero non include il carattere NULL terminante.

[in] UnicodeString

Stringa di origine Unicode per cui viene calcolata la lunghezza ANSI.

[in] BytesInUnicodeString

Numero di byte nella stringa a cui punta UnicodeString.

Valore restituito

Codice restituito	Descrizione
STATUS_SUCCESS	Il conteggio ha avuto esito positivo. I vari valori NTSTATUS sono definiti in NTSTATUS. H, distribuito con Windows DDK.

Commenti

È consigliabile usare WideCharToMultiByte anziché RtlUnicodeToMultiByteSize. Quando il parametro cbMultiByte è impostato su zero, la funzione WideCharToMultiByte restituisce il numero di byte necessari per il buffer.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winternl.h
Libreria	ntdll.lib
DLL	ntdll.dll

Condividi tramite