Funzione IdnToAscii (winnls.h)

Converte un nome di dominio internazionalizzato (IDN) o un'altra etichetta internazionalizzata in una rappresentazione Unicode (carattere wide) della stringa ASCII che rappresenta il nome nella sintassi di codifica del trasferimento punycode.

Sintassi

int IdnToAscii(
  [in]            DWORD   dwFlags,
  [in]            LPCWSTR lpUnicodeCharStr,
  [in]            int     cchUnicodeChar,
  [out, optional] LPWSTR  lpASCIICharStr,
  [in]            int     cchASCIIChar
);

Parametri

[in] dwFlags

Flag che specificano le opzioni di conversione. Nella tabella seguente sono elencati i valori possibili.

[in] lpUnicodeCharStr

Puntatore a una stringa Unicode che rappresenta un IDN o un'altra etichetta internazionalizzata.

[in] cchUnicodeChar

Numero di caratteri nella stringa Unicode di input indicata da lpUnicodeCharStr.

[out, optional] lpASCIICharStr

Puntatore a un buffer che riceve una stringa Unicode costituita solo da caratteri nel set di caratteri ASCII. Al ritorno da questa funzione, il buffer contiene l'equivalente stringa ASCII della stringa fornita in lpUnicodeCharStr in Punycode. In alternativa, la funzione può recuperare NULL per questo parametro, se cchASCIIChar è impostato su 0. In questo caso, la funzione restituisce le dimensioni necessarie per questo buffer.

[in] cchASCIIChar

Dimensione del buffer indicato da lpASCIICharStr. L'applicazione può impostare il parametro su 0 per recuperare NULL in lpASCIICharStr.

Valore restituito

Restituisce il numero di caratteri recuperati in lpASCIICharStr in caso di esito positivo. La stringa recuperata è con terminazione Null solo se la stringa Unicode di input è con terminazione Null.

Se la funzione ha esito positivo e il valore di cchASCIIChar è 0, la funzione restituisce le dimensioni necessarie, in caratteri che includono un carattere Null di terminazione se fa parte del buffer di input.

La funzione restituisce 0 se non riesce. Per ottenere informazioni estese sull'errore, l'applicazione può chiamare GetLastError, che può restituire uno dei codici di errore seguenti:

• ERROR_INSUFFICIENT_BUFFER. Le dimensioni del buffer fornite non sono sufficienti o non sono state impostate correttamente su NULL.
• ERROR_INVALID_FLAGS. I valori specificati per i flag non sono validi.
• ERROR_INVALID_NAME. Alla funzione è stato fornito un nome non valido. Si noti che questo codice di errore rileva tutti gli errori di sintassi.
• ERROR_INVALID_PARAMETER. Uno dei valori dei parametri non è valido.
• ERROR_NO_UNICODE_TRANSLATION. È stato trovato Unicode non valido in una stringa.

Commenti

La funzione non termina una stringa di output se la lunghezza della stringa di input viene specificata in modo esplicito senza un carattere Null di terminazione. Per terminare null una stringa di output per questa funzione, l'applicazione deve fornire -1 per il parametro cchUnicodeChar o contare in modo esplicito il carattere null di terminazione per la stringa di input.

Si noti che la funzione ha sempre esito negativo se la stringa di input contiene caratteri di controllo (da U+0001 a U+0020) o il carattere "delete" (U+007F). Poiché il carattere U+0000 può essere visualizzato solo come carattere Null di terminazione, la funzione ha sempre esito negativo se U+0000 viene visualizzato in qualsiasi punto della stringa di input.

Windows XP, Windows Server 2003:

Non più supportata.

Il file di intestazione e la DLL necessari fanno parte delle API di mitigazione IDN (Internationalized Domain Name) Microsoft, che non sono più disponibili per il download.

Requisiti

Vedi anche

Gestione dei nomi di dominio internazionalizzati (IDN)

IdnToNameprepUnicode

IdnToUnicode

Supporto per la lingua nazionale

Funzioni di supporto per il linguaggio nazionale