Funzione IsValidLocale (winnls.h)

  • Articolo

[IsValidLocale è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Usare invece IsValidLocaleName per determinare la validità di impostazioni locali supplementari.

Determina se le impostazioni locali specificate sono installate o supportate nel sistema operativo. Per altre informazioni, vedere Impostazioni locali e lingue.

Sintassi

BOOL IsValidLocale(
  [in] LCID  Locale,
  [in] DWORD dwFlags
);

Parametri

[in] Locale

Identificatore delle impostazioni locali da convalidare. È possibile utilizzare la macro MAKELCID per creare un identificatore delle impostazioni locali o usare uno dei valori predefiniti seguenti.

[in] dwFlags

Flag che specifica il test di validità da applicare all'identificatore delle impostazioni locali. Questo parametro può avere uno dei valori seguenti.

Valore Significato
LCID_INSTALLED
 Determinare se l'identificatore delle impostazioni locali è supportato e installato.
LCID_SUPPORTED
 Determinare se l'identificatore delle impostazioni locali è supportato.
0x39
 Non usare. Usare invece LCID_INSTALLED.

Windows Server 2008, Windows Vista, Windows Server 2003, Windows XP e Windows 2000: L'impostazione di dwFlags su 0x39 è un caso speciale che può comportarsi come LCID_INSTALLED per alcune impostazioni locali in alcune versioni di Windows.

Valore restituito

Restituisce un valore diverso da zero se l'identificatore delle impostazioni locali supera il test di validità specificato. La funzione restituisce 0 se non riesce.

Commenti

Se viene specificato il flag LCID_INSTALLED e questa funzione restituisce un valore diverso da zero, l'identificatore delle impostazioni locali è supportato e installato nel sistema operativo. La presenza di un identificatore installato implica che il livello completo di supporto per la lingua è disponibile per le impostazioni locali indicate. Il supporto completo include tabelle di conversione della tabella codici, layout di tastiera, tipi di carattere e dati di ordinamento e impostazioni locali.

Se viene specificato LCID_SUPPORTED e questa funzione restituisce 0, l'identificatore delle impostazioni locali è supportato nella versione, ma non necessariamente installato nel sistema operativo.

Questa funzione può gestire i dati dalle impostazioni locali personalizzate. Non è garantito che i dati siano gli stessi dal computer al computer o tra le esecuzioni di un'applicazione. Se l'applicazione deve rendere persistenti o trasmettere i dati, vedere Uso dei dati delle impostazioni locali persistenti.

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

Vedere anche

GetLocaleInfo

IsValidLocaleName

Supporto per la lingua nazionale

Funzioni di supporto per il linguaggio nazionale