Metode IHttpCachePolicy::AppendVaryByHeader

Menambahkan nilai header ke kebijakan cache.

Sintaks

virtual HRESULT AppendVaryByHeader(  
   PCSTR pszHeader  
) = 0;  

Parameter

pszHeader
Penunjuk ke string yang dihentikan null yang berisi header 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 pszHeader null. -atau- Menunjukkan bahwa pszHeader ditambahkan ke daftar header variabel.
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 header kustom, panggil metode IHttpContext::GetResponse, metode IHttpResponse::GetCachePolicy, dan terakhir metode .AppendVaryByHeader

AppendVaryByHeader 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 header variabel. Selama pembangunan pelaksana, buffer ini diinisialisasi kosong. Setiap kali AppendVaryByHeader dipanggil, AppendVaryByHeader segera mengembalikan S_OK jika pszHeader parameternya NULL. Jika tidak, buffer diperluas untuk menyimpan salinan pszHeader, termasuk karakter penghentian null, ditambah 1 jika buffer saat ini tidak kosong. Kemudian, jika buffer tidak kosong, karakter ',' ditambahkan ke buffer. Akhirnya, konten pszHeader, termasuk karakter penghentian null, ditambahkan ke buffer.

Catatan untuk Pelaksana

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

Catatan untuk Penelepon

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

Buffer internal yang digunakan oleh pelaksana default IHttpCachePolicy adalah string header kustom yang dibatasi koma. Oleh karena itu, pszHeader 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