Fungsi PrivacySetZonePreferenceW (winineti.h)

Menyetel pengaturan privasi untuk URLZONE dan PrivacyType tertentu.

Sintaks

DWORD PrivacySetZonePreferenceW(
  [in]           DWORD   dwZone,
  [in]           DWORD   dwType,
  [in]           DWORD   dwTemplate,
  [in, optional] LPCWSTR pszPreference
);

Parameter

[in] dwZone

Nilai jenis DWORD yang menentukan URLZONE tempat pengaturan privasi diatur.

[in] dwType

Nilai tipe DWORD yang menentukan PrivacyType yang pengaturan privasinya sedang ditetapkan.

[in] dwTemplate

Nilai jenis DWORD yang menentukan templat privasi mana yang akan digunakan untuk mengatur pengaturan privasi.

[in, optional] pszPreference

Jika dwTemplate diatur ke PRIVACY_TEMPLATE_CUSTOM, parameter ini adalah representasi string dari preferensi kustom. Jika tidak, harus diatur ke NULL. Deskripsi representasi string ini disertakan di bagian Keterangan.

Nilai kembali

Mengembalikan nol jika berhasil. Jika tidak, salah satu kesalahan yang ditentukan dalam winerr.h dikembalikan.

Keterangan

Pengaturan privasi untuk zona Internet ini ditemukan pada tab Privasi dari kotak dialog Opsi Internet .

Mengatur opsi privasi untuk URLZONE_INTERNET melibatkan pengaturan templat privasi untuk kedua PrivacyTypes. Penggoser pada Menu Privasi di Opsi Internet hanya berpindah jika privasi diatur untuk kedua Tipe Privasi.

Preferensi privasi kustom untuk URLZONE dan PrivacyType tertentu dapat diatur melalui parameter pszPreference . Parameter pszPreference dapat berisi serangkaian aturan yang dipisahkan oleh spasi kosong yang menjelaskan preferensi privasi. Penting untuk dicatat bahwa aturan itu sendiri tidak boleh berisi spasi kosong. pszPreference memiliki struktur berikut di mana mungkin ada beberapa aturan logis: < aturanlogis><tanda tangan><aturan> khusus.

Saat ini, tanda tangan harus diatur ke IE6-P3PSettings/V1:.

Aturan logika memiliki format berikut: /<expression>=<decision>/.

Ekspresi adalah pernyataan Boolean yang terdiri dari token kebijakan ringkas menggunakan operator & (logis AND) dan ! (LOGIS NOT). Token kebijakan ringkas peka huruf besar/kecil. (Untuk informasi selengkapnya tentang kebijakan privasi Platform for Privacy Preferences (P3P) dan token kebijakan ringkas, lihat spesifikasi Proyek W3C: Platform for Privacy Preferences (P3P ).) Keputusannya adalah karakter huruf kecil tunggal yang mendefinisikan tindakan yang harus diambil pada cookie yang kebijakan ringkasnya berisi token yang ditentukan. Tabel berikut ini mencantumkan karakter keputusan yang valid.

Karakter	Definisi
a	Terima kuenya.
p	Minta pengguna untuk menerima atau menolak cookie.
r	Tolak cookie.
l	Tangkap cookie (hanya kirimkan dalam konteks pihak pertama).
d	Turunkan tingkat cookie, jika cookie persisten, ke cookie sesi.

 

Aturan logika dievaluasi dalam urutan yang tercantum. Aturan logika pertama yang akan dicocokkan, jika ada, menentukan tindakan cookie.

Ekspresi kosong juga diperbolehkan. Jika ekspresi kosong, sisi kiri mengevaluasi ke true. Bentuk aturan logis ini dapat digunakan di akhir serangkaian aturan untuk menangkap semua situasi yang tidak termasuk dalam kategori lain.

Contoh berikut menunjukkan aturan logika yang valid.

/DEM=d/
    Deny a cookie whose compact policy contains the DEM token
/CON&!TEL=a/	
    Accept a cookie whose compact policy contains the CON token 
    and does not contain the TEL token
/=a/		
    Accept all cookies

Aturan khusus ditentukan menggunakan nopolicy, sesi, dan selalu simbol. Simbol nopolicy digunakan untuk menentukan tindakan yang akan diambil ketika tidak ada kebijakan yang ringkas. Misalnya nopolicy=d menentukan untuk menurunkan semua cookie tanpa kebijakan ringkas ke cookie sesi. Simbol sesi digunakan untuk menentukan tindakan yang akan diambil pada cookie sesi dan hanya dapat diatur ke a. Ketika sesi=a ditentukan, semua cookie sesi diterima terlepas dari konten kebijakan ringkas. Jika aturan ini tidak ditentukan, cookie sesi tunduk pada aturan yang sama dengan cookie persisten. Akhirnya, simbol always digunakan untuk menentukan untuk melakukan tindakan yang sama untuk semuanya. Misalnya, always=d menentukan untuk menolak semua cookie terlepas dari adanya kebijakan ringkas. Perhatikan bahwa always=d setara dengan /=d/.

Contoh berikut menunjukkan string preferensi privasi yang menentukan untuk menerima cookie yang kebijakan ringkasnya berisi pasangan token FIN/CONi, menolak cookie dengan kebijakan ringkas yang berisi FIN/CON, FIN/CONo, pasangan token FIN/CONa dan GOV/PUB atau token TEL, dan untuk meminta pengguna ketika kebijakan ringkas cookie berisi token UNR. Ini juga menentukan untuk menurunkan tingkat cookie tanpa kebijakan ringkas ke cookie sesi dan untuk menerima semua cookie yang tidak cocok dengan salah satu aturan yang diberikan. Perhatikan bahwa aturan pertama yang mengevaluasi ke true menentukan tindakan cookie.

IE6-P3PSettings/V1: /FIN&CONi=a/ /FIN&CONo=r/ /FIN&CONa=r/ /FIN&CON=r/ 
/GOV&PUB=r/ /TEL=r/ /UNR=p/ nopolicy=d /=a/

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).

 

Persyaratan

Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winineti.h (termasuk Wininet.h)
Pustaka	Wininet.lib
DLL	Wininet.dll

Lihat juga

InternetClearAllPerSiteCookieDecisions

InternetEnumPerSiteCookieDecision

InternetGetPerSiteCookieDecision

InternetSetPerSiteCookieDecision

PrivacyGetZonePreferenceW