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 tenha o 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, não incluindo o caractere nulo de terminação.

Retornar valor

Tipo: HRESULT

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

Comentários

Para as versões do Windows que não incluem GetAcceptLanguages em Shlwapi.h, a versão INDIVIDUAL ANSI ou Unicode dessa 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 em 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.

Nota Se seu aplicativo ou serviço passar marcas de idioma dessa função para qualquer função de Suporte a Idioma Nacional ou para o Microsoft .NET, ele deverá primeiro converter as marcas por meio da função ResolveLocaleName .

 

Observação

O cabeçalho shlwapi.h define GetAcceptLanguages como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlwapi.h
Biblioteca	Shlwapi.lib
DLL	Shlwapi.dll (versão 5.0 ou posterior)