Condividi tramite


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

Vedi anche

RtlFreeUnicodeString