Fungsi InternetSetCookieA (wininet.h)

Artikel
03/04/2024

Membuat cookie yang terkait dengan URL yang ditentukan.

Sintaks

BOOL InternetSetCookieA(
  [in] LPCSTR lpszUrl,
  [in] LPCSTR lpszCookieName,
  [in] LPCSTR lpszCookieData
);

Parameter

[in] lpszUrl

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

[in] lpszCookieName

Penunjuk ke string yang dihentikan null yang menentukan nama yang akan dikaitkan dengan data cookie. Jika parameter ini NULL, tidak ada nama yang terkait dengan cookie.

[in] lpszCookieData

Arahkan ke data aktual yang akan dikaitkan dengan URL.

Nilai kembali

Mengembalikan TRUE jika berhasil, atau FALSE sebaliknya. Untuk mendapatkan pesan kesalahan tertentu, panggil GetLastError.

Keterangan

Cookie yang dibuat oleh InternetSetCookie tanpa tanggal kedaluwarsa disimpan dalam memori dan hanya tersedia dalam proses yang sama yang membuatnya. Cookie yang menyertakan tanggal kedaluwarsa disimpan di direktori windows\cookies.

Membuat cookie baru dapat menyebabkan kotak dialog muncul di layar yang meminta pengguna apakah mereka ingin memperbolehkan atau melarang cookie dari situs ini berdasarkan pengaturan privasi untuk pengguna.

PerhatianInternetSetCookie akan secara tanpa syarat membuat cookie meskipun "Blokir semua cookie" diatur di Internet Explorer. Perilaku ini dapat dilihat sebagai pelanggaran privasi meskipun cookie tersebut kemudian tidak dikirim kembali ke server saat pengaturan "Blokir semua cookie" aktif. Aplikasi harus menggunakan InternetSetCookieEx untuk mematuhi pengaturan privasi pengguna dengan benar.

Untuk internal cookie lainnya, lihat http://blogs.msdn.com/ieinternals/archive/2009/08/20/WinINET-IE-Cookie-Internals-FAQ.aspx.

Seperti semua aspek lain dari Api WinINet, fungsi ini tidak dapat dipanggil dengan aman dari dalam DllMain atau konstruktor dan destruktor objek global.

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 InternetSetCookie 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 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	wininet.h
Pustaka	Wininet.lib
DLL	Wininet.dll