Função GetAcceptLanguagesA (shlwapi.h)

Recupera uma cadeia de caracteres usada com sites ao especificar preferências de idioma.

Sintaxe

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

Parâmetros

[out] pszLanguages

Tipo: LPTSTR

Um ponteiro para uma cadeia de caracteres que, quando essa função retorna com êxito, recebe as informações de preferências de idioma. Recomendamos que esse buffer seja de tamanho 2048 caracteres para garantir espaço suficiente para retornar a cadeia de caracteres completa. Você também pode chamar essa função com esse parâmetro definido como NULL para recuperar o tamanho da cadeia de caracteres que será retornada.

[in, out] pcchLanguages

Tipo: DWORD*

Um ponteiro para o tamanho, em caracteres, da cadeia de caracteres em pszLanguages.

Na entrada, esse valor é o tamanho de pszLanguages, incluindo o caractere nulo de terminação.

Na saída, é o tamanho real de pszLanguages, sem incluir o caractere nulo de terminação.

Valor de retorno

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Observações

Para as versões do Windows que não incluem GetAcceptLanguages no Shlwapi.h, a versão individual de ANSI ou Unicode desta função deve ser chamada diretamente de Shlwapi.dll. GetAcceptLanguagesA é ordinal 14 e GetAcceptLanguagesW é ordinal 15.

Alguns sites oferecem conteúdo em vários idiomas. Você pode especificar suas preferências de idioma no item Opções da Internet no Painel de Controle. GetAcceptLanguages recupera uma cadeia de caracteres que representa essas preferências. Essa cadeia de caracteres é enviada em um cabeçalho de idioma adicional ao negociar conexões HTTP.

Requisitos