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

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 .

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

Confira também

Método GetCookie

IXMLHTTPRequest2

Estrutura XHR_COOKIE

XHR_COOKIE_STATE