Función GetAcceptLanguagesA (shlwapi.h)

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.

Requisitos