Fungsi InternetSetCookieA (wininet.h)

Membuat cookie yang terkait dengan URL yang ditentukan.

Sintaksis

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

Parameter

[in] lpszUrl

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

[in] lpszCookieName

Penunjuk ke string null-dihentikan 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.

Mengembalikan nilai

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

Komentar

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 dalam direktori windows\cookies.

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

PerhatianInternetSetCookie akan membuat cookie tanpa syarat meskipun "Blokir semua cookie" diatur di Internet Explorer. Perilaku ini dapat dilihat sebagai pelanggaran privasi meskipun cookie tersebut kemudian tidak dikirim kembali ke server sementara 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.

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

 

Nota

Header wininet.h mendefinisikan InternetSetCookie sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem 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

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	wininet.h
Pustaka	Wininet.lib
DLL	Wininet.dll

Lihat juga

Cookie HTTP

InternetGetCookie

InternetGetCookieEx

InternetSetCookieEx

Mengelola Cookie

Fungsi WinINet