Fungsi HttpFlushResponseCache (http.h)

Artikel
08/24/2023

Fungsi HttpFlushResponseCache menghapus dari cache HTTP Server API yang terkait dengan permintaan tertentu mengantrekan semua fragmen respons yang memiliki nama yang bagian situsnya cocok dengan UrlPrefix tertentu. Aplikasi sebelumnya harus memanggil HttpAddUrl, atau HttpAddUrlToUrlGroup untuk menambahkan UrlPrefix ini atau awalan yang valid ke antrean permintaan yang dimaksud, lalu disebut HttpAddFragmentToCache untuk menyimpan fragmen atau fragmen respons terkait.

Sintaks

HTTPAPI_LINKAGE ULONG HttpFlushResponseCache(
  [in] HANDLE       RequestQueueHandle,
  [in] PCWSTR       UrlPrefix,
  [in] ULONG        Flags,
  [in] LPOVERLAPPED Overlapped
);

Parameter

[in] RequestQueueHandle

Tangani antrean permintaan yang terkait dengan cache ini. Antrean permintaan dibuat dan handelnya dikembalikan oleh panggilan ke fungsi HttpCreateRequestQueue .

Windows Server 2003 dengan SP1 dan Windows XP dengan SP2: Handel ke antrean permintaan dibuat oleh fungsi HttpCreateHttpHandle .

[in] UrlPrefix

Arahkan ke string UrlPrefix untuk dicocokkan dengan bagian situs dari nama fragmen. Aplikasi sebelumnya harus memanggil HttpAddUrl untuk menambahkan UrlPrefix ini atau awalan yang valid darinya ke antrean permintaan yang dimaksud, lalu memanggil HttpAddFragmentToCache untuk menyimpan fragmen respons terkait.

[in] Flags

Parameter ini dapat berisi bendera berikut:

HTTP_FLUSH_RESPONSE_FLAG_RECURSIVE

Menyebabkan fragmen respons yang memiliki nama di mana bagian situs adalah turunan hierarkis dari UrlPrefix yang ditentukan dihapus dari cache fragmen, selain fragmen yang memiliki bagian situs yang langsung cocok.

[in] Overlapped

Untuk panggilan asinkron, atur pOverlapped untuk menunjuk ke struktur TUMPANG TINDIH , atau untuk panggilan sinkron, atur ke NULL.

Panggilan sinkron memblokir hingga operasi cache selesai, sedangkan panggilan asinkron segera mengembalikan ERROR_IO_PENDING dan aplikasi panggilan kemudian menggunakan port penyelesaian GetOverlappedResult atau I/O untuk menentukan kapan operasi selesai. Untuk informasi selengkapnya tentang menggunakan struktur YANG TUMPANG TINDIH untuk sinkronisasi, lihat Sinkronisasi dan Input dan Output yang Tumpang Tindih.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan NO_ERROR.

Jika fungsi digunakan secara asinkron, nilai pengembalian ERROR_IO_PENDING menunjukkan bahwa permintaan cache diantrekan dan selesai nanti melalui mekanisme penyelesaian I/O yang tumpang tindih normal.

Jika fungsi gagal, nilai yang dikembalikan adalah salah satu kode kesalahan berikut.

Nilai	Makna
ERROR_INVALID_PARAMETER	Salah satu parameter tidak valid.
Lainnya	Kode kesalahan sistem yang ditentukan dalam WinError.h.

Persyaratan


Klien minimum yang didukung	Windows Vista, Windows XP dengan SP2 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	http.h
Pustaka	Httpapi.lib
DLL	Httpapi.dll

Lihat juga

Fungsi HTTP Server API Versi 1.0

HttpAddFragmentToCache

HttpReadFragmentFromCache

Bagikan melalui