Funzione RtlUnicodeStringToAnsiString (winternl.h)

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

Sintassi

NTSTATUS RtlUnicodeStringToAnsiString(
  [in, out] PANSI_STRING     DestinationString,
  [in]      PCUNICODE_STRING SourceString,
  [in]      BOOLEAN          AllocateDestinationString
);

Parametri

[in, out] DestinationString

Puntatore a una struttura ANSI_STRING per contenere la stringa ANSI convertita. Se AllocateDestinationString è TRUE, la routine alloca un nuovo buffer per contenere i dati della 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

Struttura UNICODE_STRING contenente la stringa di origine da convertire in ANSI.

[in] AllocateDestinationString

Controlla l'allocazione dello spazio del buffer per DestinationString.

true

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

FALSE

Lo spazio del buffer non viene allocato per DestinationString.

Valore restituito

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

Commenti

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

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

Requisiti