Compartilhar via

Método IXMLHTTPRequest2::SetCookie (msxml6.h)

  • Artigo

Define um cookie associado à URL especificada no jar de cookie HTTP.

Sintaxe

HRESULT SetCookie(
  const XHR_COOKIE *pCookie,
  DWORD            *pdwCookieState
);

Parâmetros

pCookie

Um ponteiro para uma estrutura XHR_COOKIE que especifica o cookie e as propriedades do cookie a serem associados à URL especificada.

pdwCookieState

Um ponteiro para um valor que indica o estado do cookie se a chamada for concluída com êxito.

Esse parâmetro pode ser um dos valores do tipo de enumeração XHR_COOKIE_STATE definido no arquivo de cabeçalho Msxml6.h .

Valor Significado
XHR_COOKIE_STATE_UNKNOWN
0
 Reservado.
XHR_COOKIE_STATE_ACCEPT
1
 O cookie foi aceito.
XHR_COOKIE_STATE_PROMPT
2
 O usuário é solicitado a aceitar ou recusar o cookie.
XHR_COOKIE_STATE_LEASH
3
 O cookie é aceito somente no contexto de primeira parte.
XHR_COOKIE_STATE_DOWNGRADE
4
 O cookie foi aceito e se tornou um cookie de sessão.
XHR_COOKIE_STATE_REJECT
5
 O cookie foi rejeitado.

Retornar valor

Retornará S_OK se houver êxito.

Comentários

O método SetCookie tem um comportamento diferente para aplicativos da Windows Store e aplicativos da área de trabalho do Windows.

Quando usado em um aplicativo da Windows Store, o método SetCookie por padrão define o cookie como um cookie persistente no aplicativo da Windows Store. Quando o membro dwFlags do XHR_COOKIE tiver o sinalizador XHR_COOKIE_IS_SESSION definido, o cookie será definido apenas para a sessão atual do aplicativo.

Quando usado em um aplicativo da área de trabalho do Windows, o método SetCookie por padrão define um cookie persistente que é todo o sistema e compartilhado por todos os aplicativos da área de trabalho do Windows. Quando o membro dwFlags do XHR_COOKIE tiver o sinalizador XHR_COOKIE_IS_SESSION definido, o cookie será definido apenas para a sessão atual do aplicativo da área de trabalho do Windows.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [aplicativos da área de trabalho | Aplicativos UWP], MSXML 6.0 e posterior
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho msxml6.h

Confira também

Método GetCookie

IXMLHTTPRequest2

Estrutura XHR_COOKIE

XHR_COOKIE_STATE