Funzione ConvertDefaultLocale (winnls.h)

Articolo
03/13/2024

Converte un valore delle impostazioni locali predefinito in un identificatore delle impostazioni locali effettivo.

Nota Questa funzione viene fornita solo per la conversione di identificatori di impostazioni locali parziali. Le applicazioni devono usare nomi delle impostazioni locali anziché identificatori. La funzione LCIDToLocaleName può essere utilizzata per convertire un identificatore delle impostazioni locali in un nome di impostazioni locali valido. L'applicazione può anche usare GetUserDefaultLocaleName per recuperare il nome delle impostazioni locali dell'utente corrente; GetSystemDefaultLocaleName per recuperare il nome delle impostazioni locali di sistema corrente; e GetLocaleInfoEx con LOCALE_SNAME per recuperare il nome delle impostazioni locali per tutte le impostazioni locali di input, incluse le costanti predefinite.

Sintassi

LCID ConvertDefaultLocale(
  [in] LCID Locale
);

Parametri

[in] Locale

Valore predefinito dell'identificatore delle impostazioni locali da convertire. È possibile utilizzare la macro MAKELCID per creare un identificatore delle impostazioni locali o usare uno dei valori predefiniti seguenti.

Windows Vista e versioni successive: Sono supportati anche gli identificatori di impostazioni locali personalizzati seguenti.

Valore restituito

Restituisce l'identificatore delle impostazioni locali appropriato in caso di esito positivo.

Questa funzione restituisce il valore del parametro Locale se non riesce. La funzione ha esito negativo quando il valore Locale non è uno dei valori predefiniti elencati in precedenza.

Commenti

Una chiamata a ConvertDefaultLocale che specifica LOCALE_SYSTEM_DEFAULT equivale a una chiamata a GetSystemDefaultLCID. Una chiamata a ConvertDefaultLocale che specifica LOCALE_USER_DEFAULT equivale a una chiamata a GetUserDefaultLCID.

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	winnls.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll