Função InternetGetCookieExA (wininet.h)

A função InternetGetCookieEx recupera dados armazenados em cookies associados a uma URL especificada. Ao contrário InternetGetCookie, InternetGetCookieEx podem ser usados para restringir os dados recuperados a um único nome de cookie ou, por política, associados a sites não confiáveis ou cookies de terceiros.

Sintaxe

BOOL InternetGetCookieExA(
  [in]                LPCSTR  lpszUrl,
  [in]                LPCSTR  lpszCookieName,
  [in, out, optional] LPSTR   lpszCookieData,
  [in, out]           LPDWORD lpdwSize,
  [in]                DWORD   dwFlags,
  [in]                LPVOID  lpReserved
);

Parâmetros

[in] lpszUrl

Um ponteiro para um cadeia de caracteresterminada nula que contém a URL com a qual o cookie a ser recuperado está associado. Esse parâmetro não pode ser NULL ou InternetGetCookieEx falha e retorna um erro de ERROR_INVALID_PARAMETER.

[in] lpszCookieName

Um ponteiro para um cadeia de caracteresterminada nula que contém o nome do cookie a ser recuperado. Esse nome diferencia maiúsculas de minúsculas.

[in, out, optional] lpszCookieData

Um ponteiro para um buffer para receber os dados de cookie.

[in, out] lpdwSize

Um ponteiro para uma variável DWORD.

Na entrada, a variável deve conter o tamanho, em TCHARs, do buffer apontado pelo parâmetro pchCookieData.

Na saída, se a função for bem-sucedida, essa variável conterá o número de TCHARs de dados de cookie copiados para o buffer. Se NULL foi passado como o parâmetro lpszCookieData ou se a função falhar com um erro de ERROR_INSUFFICIENT_BUFFER, a variável conterá o tamanho, em BYTEs, do buffer necessário para receber os dados de cookie.

Esse parâmetro não pode ser NULL ou InternetGetCookieEx falha e retorna um erro de ERROR_INVALID_PARAMETER.

[in] dwFlags

Um sinalizador que controla como a função recupera dados de cookie. Esse parâmetro pode ser um dos valores a seguir.

Valor	Significado
INTERNET_COOKIE_HTTPONLY	Habilita a recuperação de cookies marcados como "HTTPOnly". Não use esse sinalizador se você expor uma interface scriptável, pois isso tem implicações de segurança. É imperativo que você use esse sinalizador somente se puder garantir que nunca exporá o cookie ao código de terceiros por meio de um mecanismo de extensibilidade fornecido. versão: requer o Internet Explorer 8.0 ou posterior.
INTERNET_COOKIE_THIRD_PARTY	Recupera somente cookies de terceiros se a política permitir explicitamente que todos os cookies para a URL especificada sejam recuperados.
INTERNET_FLAG_RESTRICTED_ZONE	Recupera apenas cookies que seriam permitidos se a URL especificada não fosse confiável; ou seja, se pertencesse à zona URLZONE_UNTRUSTED.

[in] lpReserved

Reservado para uso futuro. Definir como NULL.

Valor de retorno

Se a função for bem-sucedida, a função retornará VERDADEIRO.

Se a função falhar, ela retornará FALSE . Para obter um valor de erro específico, chame GetLastError.

Se NULL for passado para lpszCookieData, a chamada terá êxito e a função não definirá ERROR_INSUFFICIENT_BUFFER.

Os códigos de erro a seguir podem ser definidos por essa função.

Código de retorno	Descrição
ERROR_INSUFFICIENT_BUFFER	Retornado se os dados de cookie recuperados forem maiores do que o tamanho do buffer apontado pelo parâmetro pcchCookieData ou se esse parâmetro for NULL.
ERROR_INVALID_PARAMETER	Retornado se o pchURL ou o parâmetro pcchCookieData estiver NULL.
ERROR_NO_MORE_ITEMS	Retornado se nenhum dado com cookie, conforme especificado, puder ser recuperado.

Observações

Observação WinINet não dá suporte a implementações de servidor. Além disso, ele não deve ser usado de um serviço. Para implementações ou serviços de servidor, use do Microsoft Windows HTTP Services (WinHTTP).

 

Nota

O cabeçalho wininet.h define InternetGetCookieEx como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	wininet.h
biblioteca	Wininet.lib
de DLL	Wininet.dll

Consulte também

de Cookies HTTP

InternetGetCookie

InternetSetCookie

InternetSetCookieEx

gerenciamento de cookies

do WinINet Functions