Metode IHttpCachePolicy::AppendVaryByQueryString

Menambahkan nilai kueri ke kebijakan cache.

Sintaks

virtual HRESULT AppendVaryByQueryString(  
   PCSTR pszParam  
) = 0;  

Parameter

pszParam
Penunjuk ke string yang dihentikan null yang berisi string kueri 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 pszParam NULL. -atau- Menunjukkan bahwa pszParam ditambahkan ke daftar kueri.
ERROR_NOT_ENOUGH_MEMORY	Menunjukkan bahwa memori tumpukan habis.
E_FAIL	Menunjukkan bahwa operasi gagal.

Keterangan

Kelas turunan CHttpModule yang mendaftar untuk peristiwa permintaan atau respons menerima penunjuk IHttpContext sebagai parameter pada metode terkaitvirtual. Untuk menambahkan kueri kustom, panggil metode IHttpContext::GetResponse , metode IHttpResponse::GetCachePolicy , dan terakhir metodenya AppendVaryByQueryString .

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

Implementer default saat ini dari antarmuka IHttpCachePolicy mendeklarasikan private buffer yang berisi data header variabel. Selama pembangunan pelaksana, buffer ini diinisialisasi kosong. Setiap kali AppendVaryByQueryString dipanggil, AppendVaryByQueryString segera mengembalikan S_OK jika pszParam parameter adalah NULL. Jika tidak, buffer diperluas untuk menyimpan salinan pszParam, termasuk karakter penghentian null, ditambah 1 jika buffer saat ini tidak kosong. Kemudian, jika buffer tidak kosong, karakter ',' ditambahkan ke buffer. Akhirnya, konten pszParam, termasuk karakter penghentian null, ditambahkan ke buffer.

Catatan untuk Pelaksana

Pelaksana IHttpCachePolicy bertanggung jawab untuk menyalin pszParam parameter ke dalam buffer, karena data yang terkait dengannya pszParam tidak dijamin valid setelah panggilan ke AppendVaryByQueryString.

Catatan untuk Penelepon

IHttpCachePolicy klien bertanggung jawab untuk meneruskan parameter NULL pszParam atau string yang dihentikan null ke AppendVaryByHeader metode . Klien juga bertanggung jawab untuk membuang pszParam setelah panggilan ke AppendVaryByHeader, karena IHttpCachePolicy pelaksana menyalin pszParam ke buffer internal.

Buffer internal yang digunakan oleh pelaksana default IHttpCachePolicy adalah string header kustom yang dibatasi koma. Oleh karena itu, pszParam tidak boleh menyertakan karakter ','.

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