Função InternetSetCookieEx2 (wininet.h)

  • Artigo

Cria um cookie associado à URL especificada.

Sintaxe

DWORD InternetSetCookieEx2(
  PCWSTR                 pcwszUrl,
  const INTERNET_COOKIE2 *pCookie,
  PCWSTR                 pcwszP3PPolicy,
  DWORD                  dwFlags,
  PDWORD                 pdwCookieState
);

Parâmetros

pcwszUrl

A URL para a qual definir o cookie.

pCookie

Ponteiro para uma estrutura INTERNET_COOKIE2 que contém os dados do cookie.

pcwszP3PPolicy

Cadeia de caracteres que contém a política P3P (Plataforma para Proteção de Privacidade) para o cookie. Pode ser NULL.

dwFlags

Sinalizadores para o cookie a ser definido. Os sinalizadores a seguir estão disponíveis.

Valor Significado
INTERNET_COOKIE_THIRD_PARTY Defina esse cookie em um contexto de terceiros.
INTERNET_COOKIE_PROMPT_REQUIRED Mostre um prompt de interface do usuário para que o usuário aceite ou rejeite esse cookie.
INTERNET_COOKIE_EVALUATE_P3P Avalie a política P3P fornecida para este cookie. Isso avaliará a política padrão quando pcwszP3PPolicy for NULL.
INTERNET_COOKIE_NON_SCRIPT Indique que esse cookie não está sendo definido por meio do JavaScript, permitindo que cookies somente HTTP sejam definidos.
INTERNET_COOKIE_APPLY_HOST_ONLY Aplique a política somente host a esse cookie. Se o atributo de domínio não estiver definido, esse cookie será marcado como somente host.

pdwCookieState

Ponteiro para um DWORD que recebe o resultado da configuração do cookie. Para obter uma lista de valores possíveis, consulte InternetCookieState.

Valor retornado

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

   
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

InternetGetCookieEx2

InternetFreeCookies

Funções WinINet