Funzione RtlAnsiStringToUnicodeString (winternl.h)

Articolo
02/01/2024

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.

Codice restituito	Descrizione
STATUS_SUCCESS	La stringa ANSI è stata convertita in Unicode. In caso di errore, la routine non alloca alcuna memoria.

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


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