Funzione RtlUTF8StringToUnicodeString (wdm.h)
La funzione RtlUTF8StringToUnicodeString converte la stringa di origine UTF8 specificata in una stringa Unicode in base alle informazioni sulle impostazioni locali di sistema correnti.
Sintassi
NTSYSAPI NTSTATUS RtlUTF8StringToUnicodeString(
PUNICODE_STRING DestinationString,
PUTF8_STRING SourceString,
BOOLEAN AllocateDestinationString
);
Parametri
DestinationString
Puntatore a una struttura UNICODE_STRING per contenere la stringa Unicode convertita.
Se AllocateDestinationString è TRUE, la routine alloca un nuovo buffer per contenere i dati stringa, aggiorna il membro Buffer di DestinationString per puntare al nuovo buffer e imposta il campo di lunghezza massima. In caso contrario, la routine usa il buffer attualmente specificato per contenere la stringa.
SourceString
Puntatore alla stringa UTF8 da convertire in Unicode.
AllocateDestinationString
Specifica se questa routine deve allocare lo spazio del buffer per la stringa di destinazione. In caso contrario, il chiamante deve deallocare il buffer chiamando RtlFreeUnicodeString.
Valore restituito
Se la conversione ha esito positivo, RtlUTF8StringToUnicodeString restituisce STATUS_SUCCESS. In caso di errore, la routine non alloca la memoria o esegue una conversione.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows 10, versione 2004 |
Intestazione | wdm.h |
IRQL | PASSIVE_LEVEL |