Función GetAcceptLanguagesA (shlwapi.h)

  • Artículo

Recupera una cadena usada con sitios web al especificar preferencias de idioma.

Sintaxis

LWSTDAPI GetAcceptLanguagesA(
  [out]     LPSTR pszLanguages,
  [in, out] DWORD *pcchLanguages
);

Parámetros

[out] pszLanguages

Tipo: LPTSTR

Puntero a una cadena que, cuando esta función devuelve correctamente, recibe la información de preferencias de idioma. Se recomienda que este búfer tenga un tamaño de 2048 caracteres para garantizar suficiente espacio para devolver la cadena completa. También puede llamar a esta función con este parámetro establecido en NULL para recuperar el tamaño de la cadena que se devolverá.

[in, out] pcchLanguages

Tipo: DWORD*

Puntero al tamaño, en caracteres, de la cadena en pszLanguages.

En la entrada, este valor es el tamaño de pszLanguages, incluido el carácter nulo de terminación.

Al salir, es el tamaño real de pszLanguages, no incluido el carácter nulo de terminación.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Para las versiones de Windows que no incluyen GetAcceptLanguages en Shlwapi.h, se debe llamar a la versión individual de ANSI o Unicode de esta función directamente desde Shlwapi.dll. GetAcceptLanguagesA es ordinal 14 y GetAcceptLanguagesW es ordinal 15.

Algunos sitios web ofrecen contenido en varios idiomas. Puede especificar sus preferencias de idioma en el elemento Opciones de Internet en Panel de control. GetAcceptLanguages recupera una cadena que representa esas preferencias. Esa cadena se envía en un encabezado de lenguaje adicional al negociar conexiones HTTP.

Nota Si la aplicación o el servicio pasa etiquetas de idioma de esta función a cualquier función de compatibilidad con lenguaje nacional o a Microsoft .NET, primero debe convertir las etiquetas a través de la función ResolveLocaleName .
 

Nota

El encabezado shlwapi.h define GetAcceptLanguages 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlwapi.h
Library Shlwapi.lib
Archivo DLL Shlwapi.dll (versión 5.0 o posterior)