Compartilhar via


Função InternetGetCookieEx2 (wininet.h)

Recupera um ou mais cookies associados à URL especificada.

Sintaxe

DWORD InternetGetCookieEx2(
  PCWSTR           pcwszUrl,
  PCWSTR           pcwszCookieName,
  DWORD            dwFlags,
  INTERNET_COOKIE2 **ppCookies,
  PDWORD           pdwCookieCount
);

Parâmetros

pcwszUrl

A URL para a qual recuperar cookies.

pcwszCookieName

O nome do cookie a ser recuperado. Pode ser NULL.

dwFlags

Sinalizadores do cookie a recuperar. Os sinalizadores a seguir estão disponíveis.

Valor Significado
INTERNET_COOKIE_THIRD_PARTY Recupere cookies como terceiros, fazendo com que cookies somente de terceiros sejam excluídos.
INTERNET_COOKIE_NON_SCRIPT Indique que essa consulta não foi disparada por meio de JavaScript, permitindo a recuperação de cookies somente HTTP.
INTERNET_COOKIE_SAME_SITE_LEVEL_CROSS_SITE Recupere cookies como se estivesse em um contexto entre sites, excluindo cookies com o conjunto de propriedades SameSite.
INTERNET_FLAG_RESTRICTED_ZONE Recupere apenas cookies que seriam permitidos se a URL especificada não fosse confiável; ou seja, se pertencesse à zona URLZONE_UNTRUSTED.

ppCookies

Ponteiro que recebe uma matriz de estruturas de INTERNET_COOKIE2 . A matriz retornada deve ser liberada por InternetFreeCookies.

pdwCookieCount

Ponteiro para um DWORD que recebe o número de estruturas na matriz.

Retornar valor

Retorna ERROR_SUCCESS se tiver êxito ou um código de erro do sistema em caso de falha.

Comentários

Observação

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 Os Serviços HTTP do Microsoft Windows (WinHTTP).

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8.1 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 R2 [somente aplicativos da área de trabalho]
Cabeçalho wininet.h
Biblioteca Wininet.lib
DLL Wininet.dll

Confira também

HTTP Cookies

Gerenciando cookies

InternetSetCookieEx2

InternetFreeCookies

Funções WinINet