Compartir a través de

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

  • Artículo

Establece una cookie asociada a la dirección URL especificada en el archivo JAR de cookies HTTP.

Sintaxis

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

Parámetros

pCookie

Puntero a una estructura de XHR_COOKIE que especifica la cookie y las propiedades de la cookie que se asociarán a la dirección URL especificada.

pdwCookieState

Puntero a un valor que indica el estado de la cookie si la llamada se completa correctamente.

Este parámetro puede ser uno de los valores del tipo de enumeración XHR_COOKIE_STATE definido en el archivo de encabezado Msxml6.h .

Valor Significado
XHR_COOKIE_STATE_UNKNOWN
0
 Reservado.
XHR_COOKIE_STATE_ACCEPT
1
 Se aceptó la cookie.
XHR_COOKIE_STATE_PROMPT
2
 Se pide al usuario que acepte o rechace la cookie.
XHR_COOKIE_STATE_LEASH
3
 La cookie solo se acepta en el contexto de primera entidad.
XHR_COOKIE_STATE_DOWNGRADE
4
 La cookie se aceptó y se convirtió en cookie de sesión.
XHR_COOKIE_STATE_REJECT
5
 Se rechazó la cookie.

Valor devuelto

Devuelve S_OK si se realiza correctamente.

Comentarios

El método SetCookie tiene un comportamiento diferente para las aplicaciones de la Tienda Windows y las aplicaciones de escritorio de Windows.

Cuando se usa en una aplicación de la Tienda Windows, el método SetCookie establece de forma predeterminada la cookie como una cookie persistente en la aplicación de la Tienda Windows. Cuando el miembro dwFlags del XHR_COOKIE tiene establecida la marca XHR_COOKIE_IS_SESSION , la cookie solo se establece para la sesión actual de la aplicación.

Cuando se usa en una aplicación de escritorio de Windows, el método SetCookie establece de forma predeterminada una cookie persistente que es amplia y compartida por todas las aplicaciones de escritorio de Windows. Cuando el miembro dwFlags del XHR_COOKIE tiene establecida la marca XHR_COOKIE_IS_SESSION , la cookie solo se establece para la sesión actual de la aplicación de escritorio de Windows.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP],MSXML 6.0 y versiones posteriores
Servidor mínimo compatible Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado msxml6.h

Consulte también

GetCookie (método)

IXMLHTTPRequest2

estructura de XHR_COOKIE

XHR_COOKIE_STATE