Función IsValidLocale (winnls.h)

[IsValidLocale está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. En su lugar, use IsValidLocaleName para determinar la validez de una configuración regional complementaria.

Determina si la configuración regional especificada está instalada o compatible con el sistema operativo. Para obtener más información, vea Configuraciones regionales e idiomas.

Sintaxis

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

Parámetros

[in] Locale

Identificador de configuración regional de la configuración regional que se va a validar. Puede usar la macro MAKELCID para crear un identificador de configuración regional o usar uno de los siguientes valores predefinidos.

• LOCALE_CUSTOM_DEFAULTWindows Server 2003, Windows XP y Windows 2000: este identificador de configuración regional no se admite.
• LOCALE_CUSTOM_UI_DEFAULTWindows Server 2003, Windows XP y Windows 2000: no se admite este identificador de configuración regional.
• LOCALE_CUSTOM_UNSPECIFIEDWindows Server 2003, Windows XP y Windows 2000: este identificador de configuración regional no se admite.
• LOCALE_INVARIANT
• LOCALE_SYSTEM_DEFAULT
• LOCALE_USER_DEFAULT

[in] dwFlags

Marca que especifica la prueba de validez que se va a aplicar al identificador de configuración regional. Este parámetro puede tener uno de los valores siguientes.

Valor devuelto

Devuelve un valor distinto de cero si el identificador de configuración regional supera la prueba de validez especificada. La función devuelve 0 si no se realiza correctamente.

Comentarios

Si se especifica la marca LCID_INSTALLED y esta función devuelve un valor distinto de cero, el identificador de configuración regional se admite e instala en el sistema operativo. Tener instalado un identificador implica que el nivel completo de compatibilidad con idiomas está disponible para la configuración regional indicada. La compatibilidad completa incluye tablas de traducción de páginas de códigos, diseños de teclado, fuentes y ordenación y datos de configuración regional.

Si se especifica LCID_SUPPORTED y esta función devuelve 0, el identificador de configuración regional se admite en la versión, pero no necesariamente instalado en el sistema operativo.

Esta función puede controlar los datos de configuraciones regionales personalizadas. No se garantiza que los datos sean los mismos desde el equipo al equipo o entre ejecuciones de una aplicación. Si la aplicación debe conservar o transmitir datos, consulte Uso de datos de configuración regional persistente.

Requisitos

Vea también

GetLocaleInfo

IsValidLocaleName

Compatibilidad con idiomas nacionales

Funciones de compatibilidad con idiomas nacionales