Compartir a través de

Función VerLanguageNameA (winver.h)

  • Artículo

Recupera una cadena de descripción para el idioma asociado a un identificador de idioma binario de Microsoft especificado.

Sintaxis

DWORD VerLanguageNameA(
  [in]  DWORD wLang,
  [out] LPSTR szLang,
  [in]  DWORD cchLang
);

Parámetros

[in] wLang

Tipo: DWORD de

Identificador del lenguaje binario. Para obtener una lista completa de los identificadores de idioma, consulte Identificadores de idioma.

Por ejemplo, la cadena de descripción asociada al identificador de idioma 0x040A es "Español (Ordenación tradicional)". Si se desconoce el identificador, el parámetro szLang apunta a una cadena predeterminada ("Language Neutral").

[out] szLang

Tipo: LPTSTR de

Idioma especificado por el parámetro wLang.

[in] cchLang

Tipo: DWORD de

Tamaño, en caracteres, del búfer al que apunta szLang.

Valor devuelto

Tipo: DWORD de

El valor devuelto es el tamaño, en caracteres, de la cadena devuelta en el búfer. Este valor no incluye el carácter nulo de terminación. Si la cadena de descripción es menor o igual que el búfer, toda la cadena de descripción se encuentra en el búfer. Si la cadena de descripción es mayor que el búfer, la cadena de descripción se trunca hasta la longitud del búfer.

Si se produce un error, el valor devuelto es cero. Los identificadores de idioma desconocidos no producen errores.

Observaciones

Esta función funciona en imágenes de archivo de 16, 32 y 64 bits.

Normalmente, un programa de instalación usa esta función para traducir un identificador de lenguaje devuelto por la función VerQueryValue. La cadena de texto se puede usar en un cuadro de diálogo que le pida al usuario cómo continuar en caso de conflicto de idioma.

Nota

El encabezado winver.h define VerLanguageName como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de winver.h (incluya Windows.h)
biblioteca de Version.lib
DLL de Api-ms-win-core-localization-l1-2-1.dll

Consulte también

Información general de la versión de