Funzione RtlUnicodeStringToAnsiString (winternl.h)

Articolo
03/04/2024

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.

Codice restituito	Descrizione
STATUS_SUCCESS	La stringa Unicode è stata convertita in ANSI. In caso contrario, nessuna risorsa di archiviazione è stata allocata e non è stata eseguita alcuna conversione.

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

Requisito	Valore
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; NtosKrnl.exe

Condividi tramite