Funzione RtlUnicodeStringToAnsiString (wdm.h)

  • Articolo

La routine RtlUnicodeStringToAnsiString converte una stringa Unicode specificata in una stringa ANSI.

Sintassi

NTSYSAPI 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 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 stringa di origine Unicode da convertire in ANSI.

[in] AllocateDestinationString

TRUE se questa routine consiste nell'allocare lo spazio del buffer per DestinationString. In caso affermativo, il buffer deve essere deallocato chiamando RtlFreeAnsiString.

Valore restituito

Se la conversione ha esito positivo, RtlUnicodeStringToAnsiString restituisce STATUS_SUCCESS. In caso contrario, nessuna risorsa di archiviazione è stata allocata e non è stata eseguita alcuna conversione.

Commenti

La traduzione viene eseguita in accordo con le informazioni locali di sistema correnti.

Requisiti

Requisito Valore
Client minimo supportato Disponibile a partire da Windows 2000.
Piattaforma di destinazione Universale
Intestazione wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Vedi anche

ANSI_STRING

RtlAnsiStringToUnicodeString

RtlFreeAnsiString

UNICODE_STRING