Função InternetSetCookieExA (wininet.h)

A função InternetSetCookieEx cria um cookie com um nome especificado associado a uma URL especificada. Essa função difere da função InternetSetCookie por poder criar cookies de terceiros.

Sintaxe

DWORD InternetSetCookieExA(
  [in] LPCSTR    lpszUrl,
  [in] LPCSTR    lpszCookieName,
  [in] LPCSTR    lpszCookieData,
  [in] DWORD     dwFlags,
  [in] DWORD_PTR dwReserved
);

Parâmetros

[in] lpszUrl

Ponteiro para um cadeia de caracteresterminada nula que contém a URL para a qual o cookie deve ser definido.

Se esse ponteiro estiver NULL, InternetSetCookieEx falhará com um erro de ERROR_INVALID_PARAMETER.

[in] lpszCookieName

Ponteiro para um cadeia de caracteresterminada nula que contém o nome a ser associado a esse cookie. Se esse ponteiro for NULL, nenhum nome será associado ao cookie.

[in] lpszCookieData

Ponteiro para um cadeia de caracteresterminada nula que contém os dados a serem associados ao novo cookie.

Se esse ponteiro estiver NULL, InternetSetCookieEx falhará com um erro de ERROR_INVALID_PARAMETER.

[in] dwFlags

Sinalizadores que controlam como a função recupera dados de cookie:

Valor	Significado
INTERNET_COOKIE_EVALUATE_P3P	Se esse sinalizador estiver definido e o parâmetro dwReserved não for NULL, o parâmetro dwReserved será convertido em um LPCTSTR que aponta para um cabeçalho P3P (Platform-for-Privacy-Protection) para o cookie em questão.
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. Se você expor uma interface com script, poderá se tornar um vetor de ataque para ataques de script entre sites. É absolutamente imperativo que você use esse sinalizador somente se eles puderem garantir que você nunca permitirá que o código de terceiros defina um cookie usando esse sinalizador por meio de um mecanismo de extensibilidade fornecido. versão: requer o Internet Explorer 8.0 ou posterior.
INTERNET_COOKIE_THIRD_PARTY	Indica que o cookie que está sendo definido é um cookie de terceiros.
INTERNET_FLAG_RESTRICTED_ZONE	Indica que o cookie que está sendo definido está associado a um site não confiável.

[in] dwReserved

NULL ou contém um ponteiro para um cabeçalho P3P (Platform-for-Privacy-Protection) a ser associado ao cookie.

Valor de retorno

Retorna um membro da enumeração InternetCookieState se tiver êxito ou FALSE se a função falhar. Em caso de falha, se uma chamada para GetLastError retornar ERROR_NOT_ENOUGH_MEMORY, a memória insuficiente do sistema estará disponível.

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 InternetSetCookieEx 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

InternetGetCookieEx

InternetSetCookie

gerenciamento de cookies

do WinINet Functions