Função InternetSetCookieA (wininet.h)

Cria um cookie associado à URL especificada.

Sintaxe

BOOL InternetSetCookieA(
  [in] LPCSTR lpszUrl,
  [in] LPCSTR lpszCookieName,
  [in] LPCSTR lpszCookieData
);

Parâmetros

[in] lpszUrl

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

[in] lpszCookieName

Ponteiro para um cadeia de caracteresterminada nula que especifica o nome a ser associado aos dados de cookie. Se esse parâmetro for NULL, nenhum nome será associado ao cookie.

[in] lpszCookieData

Ponteiro para os dados reais a serem associados à URL.

Valor de retorno

Retorna TRUE se tiver êxito ou false caso contrário. Para obter uma mensagem de erro específica, chame GetLastError.

Observações

Os cookies criados por InternetSetCookie sem uma data de validade são armazenados na memória e estão disponíveis apenas no mesmo processo que os criou. Os cookies que incluem uma data de validade são armazenados no diretório windows\cookies.

A criação de um novo cookie pode fazer com que uma caixa de diálogo apareça na tela perguntando ao usuário se ele deseja permitir ou não cookies deste site com base nas configurações de privacidade do usuário.

CuidadointernetSetCookie criará incondicionalmente um cookie mesmo se "Bloquear todos os cookies" estiver definido no Internet Explorer. Esse comportamento pode ser visto como uma violação de privacidade, embora esses cookies não sejam posteriormente enviados de volta aos servidores enquanto a configuração "Bloquear todos os cookies" estiver ativa. Os aplicativos devem usar InternetSetCookieEx para respeitar corretamente as configurações de privacidade do usuário.

Para obter mais cookies internos, consulte http://blogs.msdn.com/ieinternals/archive/2009/08/20/WinINET-IE-Cookie-Internals-FAQ.aspx.

 

Assim como todos os outros aspectos da API WinINet, essa função não pode ser chamada com segurança de dentro do DllMain ou dos construtores e destruidores de objetos globais.

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 InternetSetCookie 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 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [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

InternetSetCookieEx

gerenciamento de cookies

do WinINet Functions