Compartir a través de

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 de

Puntero a una cadena que, cuando esta función se 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 espacio suficiente 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* de

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, sin incluir el carácter nulo de terminación.

Valor devuelto

Tipo: HRESULT

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

Observaciones

Para esas versiones de Windows que no incluyen GetAcceptLanguages en Shlwapi.h, se debe llamar directamente a la versión anSI o Unicode individual de esta función 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 el 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 función de compatibilidad con idiomas nacionales 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 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, Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de shlwapi.h
biblioteca de Shlwapi.lib
DLL de Shlwapi.dll (versión 5.0 o posterior)