Metode IHttpCachePolicy::SetVaryByValue

Mengatur nilai variabel untuk kebijakan cache.

Sintaks

virtual HRESULT SetVaryByValue(  
   PCSTR pszValue  
) = 0;  

Parameter

pszValue
Penunjuk ke string yang dihentikan null yang berisi nilai kustom untuk ditambahkan.

-atau-

NULL.

Tampilkan Nilai

Sebuah HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Nilai	Deskripsi
S_OK	Menunjukkan bahwa operasi berhasil.
E_INVALIDARG	Menunjukkan bahwa pszValue null.
ERROR_ARITHMETIC_OVERFLOW	Menunjukkan bahwa panjang pszValue melebihi batas maksimum.

Keterangan

Kelas turunan CHttpModule yang mendaftar untuk peristiwa permintaan atau respons menerima penunjuk IHttpContext sebagai parameter pada metode terkaitvirtual. Untuk mengatur nilai variabel, panggil metode IHttpContext::GetResponse, metode IHttpResponse::GetCachePolicy, dan terakhir metode .SetVaryByValue

SetVaryByValue perilaku tergantung pada implementasi. Anda harus menggunakan informasi berikut sebagai pedoman, tetapi mungkin tidak benar dalam semua skenario:

• Implementer default antarmuka IHttpCachePolicy saat ini mendeklarasikan private buffer yang berisi data variabel. Selama pembangunan pelaksana, buffer ini diinisialisasi kosong.

• SetVaryByValue mengembalikan E_INVALIDARG segera jika pszValue parameter adalah NULL. Jika tidak, buffer internal diperluas, jika perlu, untuk menyimpan konten pszValue dan karakter penghentian null. Kemudian pszValue, diikuti oleh karakter null-termination, disalin ke dalam buffer ini. Setiap data dalam buffer sebelum panggilan ke SetVaryByValue ditimpa, jika perlu, selama panggilan ke SetVaryByValue.

Catatan untuk Pelaksana

Implementer IHttpCachePolicy bertanggung jawab untuk menyalin pszValue parameter ke dalam buffer, karena data yang terkait dengan pszValue parameter tidak dijamin valid setelah panggilan ke SetVaryByValue.

Catatan untuk Penelepon

IHttpCachePolicy klien bertanggung jawab untuk meneruskan string yang dihentikan null ke SetVaryByValue metode . Klien juga bertanggung jawab untuk membuang pszValue setelah panggilan ke SetVaryByValue, karena IHttpCachePolicy pelaksana menyalin pszValue ke buffer internal.

Persyaratan

Jenis	Deskripsi
Klien	- IIS 7.0 di Windows Vista - IIS 7.5 di Windows 7 - IIS 8.0 di Windows 8 - IIS 10.0 pada Windows 10
Server	- IIS 7.0 di Windows Server 2008 - IIS 7.5 di Windows Server 2008 R2 - IIS 8.0 di Windows Server 2012 - IIS 8.5 di Windows Server 2012 R2 - IIS 10.0 di Windows Server 2016
Produk	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 - IIS Express 7.5, IIS Express 8.0, IIS Express 10.0
Header	Httpserv.h

Lihat juga

Antarmuka IHttpCachePolicy