Funzione RtlUnicodeStringToAnsiString (wdm.h)
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 |