Função InternetSetCookieExW (wininet.h)

Artigo
08/27/2023

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 ser capaz de criar cookies de terceiros.

Sintaxe

DWORD InternetSetCookieExW(
  [in] LPCWSTR   lpszUrl,
  [in] LPCWSTR   lpszCookieName,
  [in] LPCWSTR   lpszCookieData,
  [in] DWORD     dwFlags,
  [in] DWORD_PTR dwReserved
);

Parâmetros

[in] lpszUrl

Ponteiro para uma cadeia de caracteres terminada em nulo que contém a URL para a qual o cookie deve ser definido.

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

[in] lpszCookieName

Ponteiro para uma cadeia de caracteres terminada em nulo 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 uma cadeia de caracteres terminada em nulo que contém os dados a serem associados ao novo cookie.

Se esse ponteiro for 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 for 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 com script, pois isso tem implicações de segurança. Se você expor uma interface scriptável, 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 a 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 (Plataforma para Proteção de Privacidade) a ser associado ao cookie.

Retornar valor

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.

Comentários

Nota 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).

Observação

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

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