Función VerLanguageNameA (winver.h)

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

Identificador de 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 el identificador es desconocido, el parámetro szLang apunta a una cadena predeterminada ("Language Neutral").

[out] szLang

Tipo: LPTSTR

Idioma especificado por el parámetro wLang .

[in] cchLang

Tipo: DWORD

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

Valor devuelto

Tipo: DWORD

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, la cadena de descripción completa 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 idioma devuelto por la función VerQueryValue . La cadena de texto se puede usar en un cuadro de diálogo que pregunte 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 Convenciones para prototipos de función.

Requisitos

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	winver.h (incluye Windows.h)
Library	Version.lib
Archivo DLL	Api-ms-win-core-localization-l1-2-1.dll

Consulte también

Información general sobre la información de versión