Metode IXMLHTTPRequest2::SetCookie (msxml6.h)

Artikel
02/29/2024

Mengatur cookie yang terkait dengan URL yang ditentukan dalam jar cookie HTTP.

Sintaks

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

Parameter

pCookie

Penunjuk ke struktur XHR_COOKIE yang menentukan cookie dan properti cookie yang akan dikaitkan dengan URL yang ditentukan.

pdwCookieState

Penunjuk ke nilai yang menunjukkan status cookie jika panggilan berhasil diselesaikan.

Parameter ini dapat menjadi salah satu nilai dari jenis enumerasi XHR_COOKIE_STATE yang ditentukan dalam file header Msxml6.h .

Nilai	Makna
XHR_COOKIE_STATE_UNKNOWN 0	Dicadangkan.
XHR_COOKIE_STATE_ACCEPT 1	Cookie diterima.
XHR_COOKIE_STATE_PROMPT 2	Pengguna diminta untuk menerima atau menolak cookie.
XHR_COOKIE_STATE_LEASH 3	Cookie hanya diterima dalam konteks pihak pertama.
XHR_COOKIE_STATE_DOWNGRADE 4	Cookie diterima dan menjadi cookie sesi.
XHR_COOKIE_STATE_REJECT 5	Cookie ditolak.

Nilai kembali

Mengembalikan S_OK pada keberhasilan.

Keterangan

Metode SetCookie memiliki perilaku yang berbeda untuk aplikasi Windows Store dan aplikasi desktop Windows.

Saat digunakan dalam aplikasi Windows Store, metode SetCookie secara default mengatur cookie sebagai cookie persisten di aplikasi Windows Store. Ketika anggota dwFlagsdari XHR_COOKIE memiliki bendera XHR_COOKIE_IS_SESSION yang ditetapkan, maka cookie diatur hanya untuk sesi aplikasi saat ini.

Ketika digunakan dalam aplikasi desktop Windows, metode SetCookie secara default menetapkan cookie persisten yang lebar dan dibagikan oleh semua aplikasi desktop Windows. Ketika anggota dwFlagsdari XHR_COOKIE memiliki bendera XHR_COOKIE_IS_SESSION diatur, maka cookie diatur hanya untuk sesi aplikasi desktop Windows saat ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [aplikasi desktop \| Aplikasi UWP],MSXML 6.0 dan yang lebih baru
Server minimum yang didukung	Windows Server 2012 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	msxml6.h

Lihat juga

Bagikan melalui