Fungsi InternetSetCookieExW (wininet.h)

Artikel
08/27/2023

Fungsi InternetSetCookieEx membuat cookie dengan nama tertentu yang terkait dengan URL tertentu. Fungsi ini berbeda dari fungsi InternetSetCookie dengan dapat membuat cookie pihak ketiga.

Sintaks

DWORD InternetSetCookieExW(
  [in] LPCWSTR   lpszUrl,
  [in] LPCWSTR   lpszCookieName,
  [in] LPCWSTR   lpszCookieData,
  [in] DWORD     dwFlags,
  [in] DWORD_PTR dwReserved
);

Parameter

[in] lpszUrl

Penunjuk ke string yang dihentikan null yang berisi URL tempat cookie harus diatur.

Jika pointer ini ADALAH NULL, InternetSetCookieEx gagal dengan kesalahan ERROR_INVALID_PARAMETER .

[in] lpszCookieName

Penunjuk ke string yang dihentikan null yang berisi nama untuk dikaitkan dengan cookie ini. Jika pointer ini ADALAH NULL, maka tidak ada nama yang terkait dengan cookie.

[in] lpszCookieData

Penunjuk ke string yang dihentikan null yang berisi data yang akan dikaitkan dengan cookie baru.

Jika pointer ini ADALAH NULL, InternetSetCookieEx gagal dengan kesalahan ERROR_INVALID_PARAMETER .

[in] dwFlags

Bendera yang mengontrol cara fungsi mengambil data cookie:

Nilai	Makna
INTERNET_COOKIE_EVALUATE_P3P	Jika bendera ini diatur dan parameter dwReserved bukan NULL, maka parameter dwReserved ditransmisikan ke LPCTSTR yang menunjuk ke header Platform-for-Privacy-Protection (P3P) untuk cookie yang dimaksud.
INTERNET_COOKIE_HTTPONLY	Mengaktifkan pengambilan cookie yang ditandai sebagai "HTTPOnly". Jangan gunakan bendera ini jika Anda mengekspos antarmuka yang dapat ditulis, karena ini memiliki implikasi keamanan. Jika Anda mengekspos antarmuka yang dapat ditulis, Anda dapat menjadi vektor serangan untuk serangan scripting lintas situs. Sangat penting bahwa Anda menggunakan bendera ini hanya jika mereka dapat menjamin bahwa Anda tidak akan pernah mengizinkan kode pihak ketiga untuk mengatur cookie menggunakan bendera ini dengan cara mekanisme ekstensibilitas yang Anda berikan. Versi: Memerlukan Internet Explorer 8.0 atau yang lebih baru.
INTERNET_COOKIE_THIRD_PARTY	Menunjukkan bahwa cookie yang ditetapkan adalah cookie pihak ketiga.
INTERNET_FLAG_RESTRICTED_ZONE	Menunjukkan bahwa cookie yang ditetapkan dikaitkan dengan situs yang tidak tepercaya.

[in] dwReserved

NULL, atau berisi penunjuk ke header Platform-for-Privacy-Protection (P3P) yang akan dikaitkan dengan cookie.

Nilai kembali

Mengembalikan anggota enumerasi InternetCookieState jika berhasil, atau FALSE jika fungsi gagal. Jika gagal, jika panggilan ke GetLastError mengembalikan ERROR_NOT_ENOUGH_MEMORY, memori sistem yang tidak mencukupi tersedia.

Keterangan

Catatan WinINet tidak mendukung implementasi server. Selain itu, itu tidak boleh digunakan dari layanan. Untuk implementasi atau layanan server, gunakan Microsoft Windows HTTP Services (WinHTTP).

Catatan

Header wininet.h mendefinisikan InternetSetCookieEx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	wininet.h
Pustaka	Wininet.lib
DLL	Wininet.dll