Função InternetSetCookieW (wininet.h)
Cria um cookie associado à URL especificada.
Sintaxe
BOOL InternetSetCookieW(
[in] LPCWSTR lpszUrl,
[in] LPCWSTR lpszCookieName,
[in] LPCWSTR lpszCookieData
);
Parâmetros
[in] lpszUrl
Ponteiro para uma cadeia de caracteres terminada em nulo que especifica a URL para a qual o cookie deve ser definido.
[in] lpszCookieName
Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome a ser associado aos dados do 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 retornado
Retornará TRUE se tiver êxito ou FALSE caso contrário. Para obter uma mensagem de erro específica, chame GetLastError.
Comentários
Os cookies criados por InternetSetCookie sem uma data de validade são armazenados na memória e estão disponíveis somente 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.
Para obter mais informações internas de cookie, consulte http://blogs.msdn.com/ieinternals/archive/2009/08/20/WinINET-IE-Cookie-Internals-FAQ.aspx.
Como todos os outros aspectos da API WinINet, essa função não pode ser chamada com segurança de dentro de DllMain ou dos construtores e destruidores de objetos globais.
Observação
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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | wininet.h |
Biblioteca | Wininet.lib |
DLL | Wininet.dll |