Compartir a través de

Función IsValidLocale (winnls.h)

  • Artículo

[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.

[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 Significado
LCID_INSTALLED
 Determine si el identificador de configuración regional es compatible e instalado.
LCID_SUPPORTED
 Determine si se admite el identificador de configuración regional.
0x39
 No debe usarse. En su lugar, use LCID_INSTALLED.

Windows Server 2008, Windows Vista, Windows Server 2003, Windows XP y Windows 2000: Establecer dwFlags en 0x39 es un caso especial que puede comportarse como LCID_INSTALLED para algunas configuraciones regionales en algunas versiones de Windows.

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

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winnls.h (incluye Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

GetLocaleInfo

IsValidLocaleName

Compatibilidad con idiomas nacionales

Funciones de compatibilidad con idiomas nacionales