Funzione RtlAnsiStringToUnicodeString (winternl.h)

Converte la stringa di origine ANSI specificata in una stringa Unicode.

Sintassi

NTSTATUS RtlAnsiStringToUnicodeString(
  [in, out] PUNICODE_STRING DestinationString,
  [in]      PCANSI_STRING   SourceString,
  [in]      BOOLEAN         AllocateDestinationString
);

Parametri

[in, out] 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 e aggiorna il membro Buffer di DestinationString per puntare al nuovo buffer. In caso contrario, la routine usa il buffer attualmente specificato per contenere la stringa.

[in] SourceString

Puntatore alla struttura ANSI_STRING contenente la stringa ANSI da convertire in Unicode.

[in] AllocateDestinationString

Controlla l'allocazione dello spazio del buffer per la stringa di destinazione.

true

Lo spazio del buffer viene allocato per DestinationString. Se impostato su TRUE, il buffer deve essere deallocato usando RtlFreeUnicodeString.

FALSE

Lo spazio del buffer non viene allocato per DestinationString.

Valore restituito

I vari valori NTSTATUS sono definiti in NTSTATUS. H, distribuito con Windows DDK.

Commenti

La traduzione viene eseguita rispetto alle informazioni sulle impostazioni locali del sistema correnti.

Se il chiamante imposta AllocateDestinationString su TRUE, la routine sostituisce il membro Buffer di DestinationString con un puntatore al buffer allocato. Il valore precedente può essere sovrascritto anche quando la routine restituisce un codice di stato di errore.

Poiché non è disponibile alcuna libreria di importazione per questa funzione, è necessario usare GetProcAddress.

Requisiti