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 |