Condividi tramite


Metodo IXMLHTTPRequest2::SetCookie (msxml6.h)

Imposta un cookie associato all'URL specificato nel file JAR del cookie HTTP.

Sintassi

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

Parametri

pCookie

Puntatore a una struttura XHR_COOKIE che specifica il cookie e le proprietà del cookie da associare all'URL specificato.

pdwCookieState

Puntatore a un valore che indica lo stato del cookie se la chiamata viene completata correttamente.

Questo parametro può essere uno dei valori del tipo di enumerazione XHR_COOKIE_STATE definito nel file di intestazione Msxml6.h .

Valore Significato
XHR_COOKIE_STATE_UNKNOWN
0
Riservato.
XHR_COOKIE_STATE_ACCEPT
1
Il cookie è stato accettato.
XHR_COOKIE_STATE_PROMPT
2
All'utente viene richiesto di accettare o rifiutare il cookie.
XHR_COOKIE_STATE_LEASH
3
Il cookie viene accettato solo nel contesto di prima parte.
XHR_COOKIE_STATE_DOWNGRADE
4
Il cookie è stato accettato ed è diventato cookie di sessione.
XHR_COOKIE_STATE_REJECT
5
Il cookie è stato rifiutato.

Valore restituito

Restituisce S_OK in caso di esito positivo.

Commenti

Il metodo SetCookie ha un comportamento diverso per le app di Windows Store e le applicazioni desktop di Windows.

Se usato in un'app di Windows Store, il metodo SetCookie imposta per impostazione predefinita il cookie come cookie persistente nell'app di Windows Store. Quando il membro dwFlags del XHR_COOKIE ha il flag XHR_COOKIE_IS_SESSION impostato, il cookie viene impostato solo per la sessione corrente dell'app.

Se usato in un'applicazione desktop di Windows, il metodo SetCookie imposta per impostazione predefinita un cookie persistente che è a livello di sistema e condiviso da tutte le applicazioni desktop di Windows. Quando il membro dwFlags del XHR_COOKIE ha il flag XHR_COOKIE_IS_SESSION impostato, il cookie viene impostato solo per la sessione corrente dell'applicazione desktop di Windows.

Requisiti

Requisito Valore
Client minimo supportato Windows 8 [app desktop | App UWP],MSXML 6.0 e versioni successive
Server minimo supportato Windows Server 2012 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione msxml6.h

Vedi anche

GetCookie, metodo

IXMLHTTPRequest2

Struttura XHR_COOKIE

XHR_COOKIE_STATE