Funzione RtlUnicodeStringToUTF8String (wdm.h)
La funzione RtlUnicodeStringToUTF8String converte la stringa di origine Unicode specificata in una stringa UTF8.
Sintassi
NTSYSAPI NTSTATUS RtlUnicodeStringToUTF8String(
PUTF8_STRING DestinationString,
PCUNICODE_STRING SourceString,
BOOLEAN AllocateDestinationString
);
Parametri
DestinationString
Puntatore a una struttura UTF8_STRING per contenere la stringa UTF8 convertita. Se AllocateDestinationString è TRUE, la routine alloca un nuovo buffer per contenere i dati stringa e aggiorna il membro Buffer di DestinationString in modo che punti al nuovo buffer. In caso contrario, la routine usa il buffer attualmente specificato per contenere la stringa. Il campo di lunghezza massima viene impostato solo se AllocateDestinationString è TRUE.
SourceString
Puntatore alla stringa di origine Unicode da convertire in UTF8.
AllocateDestinationString
TRUE se questa routine deve allocare lo spazio buffer per DestinationString. In caso affermativo, il buffer deve essere deallocato chiamando RtlFreeUTF8String.
Valore restituito
Se la conversione ha esito positivo, RtlUnicodeStringToUTF8String restituisce STATUS_SUCCESS. In caso di errore, la routine non alloca memoria né esegue una conversione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 10, versione 2004 |
| Intestazione | wdm.h |
| IRQL | PASSIVE_LEVEL |