Funzione ResolveLocaleName (winnls.h)

Trova una possibile corrispondenza del nome delle impostazioni locali per il nome specificato.

Sintassi

int ResolveLocaleName(
  [in, optional]  LPCWSTR lpNameToResolve,
  [out, optional] LPWSTR  lpLocaleName,
  [in]            int     cchLocaleName
);

Parametri

[in, optional] lpNameToResolve

Puntatore a un nome da risolvere, ad esempio "en-XA" per l'inglese (uso privato).

[out, optional] lpLocaleName

Puntatore a un buffer in cui questa funzione recupera il nome delle impostazioni locali corrispondente al nome di input. Ad esempio, la corrispondenza per il nome "en-XA" è "en-US" per l'inglese (Stati Uniti).

Nota Se la funzione ha esito negativo, lo stato del buffer di output non è garantito che sia accurato. In questo caso, l'applicazione deve controllare il valore restituito e lo stato di errore impostati dalla funzione per determinare il corso corretto dell'azione.

 

[in] cchLocaleName

Dimensioni, in caratteri, del buffer indicato da lpLocaleName. La lunghezza massima possibile di un nome delle impostazioni locali, incluso un carattere Null di terminazione, è il valore di LOCALE_NAME_MAX_LENGTH. Questa è la dimensione consigliata da specificare in questo parametro.

Valore restituito

Restituisce le dimensioni del buffer contenente il nome delle impostazioni locali, incluso il carattere Null di terminazione, se l'operazione riesce.

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.

Commenti

Il nome delle impostazioni locali recuperate indica impostazioni locali specifiche, tra cui lingua e paese/area geografica, anche se la lingua di input è neutra. Ad esempio, un input di "en" per l'inglese (Stati Uniti) fa sì che la funzione recuperi "en-US".

Questa funzione può recuperare dati dalle impostazioni locali personalizzate. Non è garantito che i dati siano uguali dal computer al computer o tra le esecuzioni di un'applicazione, né la restituzione di impostazioni locali valide garantisce che sia valida in un altro computer. Se l'applicazione deve rendere persistenti o trasmettere i dati, vedere Uso dei dati delle impostazioni locali persistenti.

A partire da Windows 8: I tag di lingua ottenuti dallo spazio dei nomi Windows.Globalization devono essere convertiti da ResolveLocaleName prima di poter essere usati con qualsiasi funzione di supporto per il linguaggio nazionale.

Requisiti

Client minimo supportato	Windows 7 [app desktop | App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	winnls.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

Supporto per la lingua nazionale

Funzioni di supporto per il linguaggio nazionale

Windows.Globalization