HttpFlushResponseCache-Funktion (http.h)
Die HttpFlushResponseCache-Funktion entfernt aus dem HTTP-Server-API-Cache, der einer bestimmten Anforderungswarteschlange zugeordnet ist, alle Antwortfragmente, die einen Namen haben, dessen Websiteteil mit einem angegebenen UrlPrefix übereinstimmt. Die Anwendung muss zuvor HttpAddUrl oder HttpAddUrlToUrlGroup aufgerufen haben, um dieses UrlPrefix oder ein gültiges Präfix zur betreffenden Anforderungswarteschlange hinzuzufügen, und dann HttpAddFragmentToCache aufgerufen haben, um das zugeordnete Antwortfragment oder die zugehörigen Antwortfragmentfragmente zwischenzuspeichern.
Syntax
HTTPAPI_LINKAGE ULONG HttpFlushResponseCache(
[in] HANDLE RequestQueueHandle,
[in] PCWSTR UrlPrefix,
[in] ULONG Flags,
[in] LPOVERLAPPED Overlapped
);
Parameter
[in] RequestQueueHandle
Handle mit der Anforderungswarteschlange, der dieser Cache zugeordnet ist. Eine Anforderungswarteschlange wird erstellt, und ihr Handle wird durch einen Aufruf der HttpCreateRequestQueue-Funktion zurückgegeben.
Windows Server 2003 mit SP1 und Windows XP mit SP2: Das Handle für die Anforderungswarteschlange wird von der HttpCreateHttpHandle-Funktion erstellt.
[in] UrlPrefix
Zeiger auf eine UrlPrefix-Zeichenfolge , die mit dem Websiteteil der Fragmentnamen abgeglichen werden soll. Die Anwendung muss zuvor HttpAddUrl aufgerufen haben, um dieses UrlPrefix oder ein gültiges Präfix zur betreffenden Anforderungswarteschlange hinzuzufügen, und dann HttpAddFragmentToCache aufgerufen haben, um das zugeordnete Antwortfragment zwischenzuspeichern.
[in] Flags
Dieser Parameter kann das folgende Flag enthalten:
HTTP_FLUSH_RESPONSE_FLAG_RECURSIVE
Bewirkt, dass Antwortfragmente mit Namen, in denen der Websiteteil ein hierarchischer Nachfolger des angegebenen UrlPrefix ist, aus dem Fragmentcache entfernt werden, zusätzlich zu den Fragmenten, die direkt übereinstimmen.
[in] Overlapped
Legen Sie für asynchrone Aufrufe pOverlapped so fest, dass er auf eine OVERLAPPED-Struktur verweist, oder legen Sie ihn für synchrone Aufrufe auf NULL fest.
Ein synchroner Aufruf blockiert, bis der Cachevorgang abgeschlossen ist, während ein asynchroner Aufruf sofort ERROR_IO_PENDING zurückgibt und die aufrufende Anwendung dann GetOverlappedResult - oder E/A-Abschlussports verwendet, um zu bestimmen, wann der Vorgang abgeschlossen ist. Weitere Informationen zur Verwendung von OVERLAPPED-Strukturen für die Synchronisierung finden Sie unter Synchronisierung und überlappende Eingabe und Ausgabe.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.
Wenn die Funktion asynchron verwendet wird, gibt der Rückgabewert ERROR_IO_PENDING an, dass die Cacheanforderung in die Warteschlange eingereiht wird und später über normale überlappende E/A-Vervollständigungsmechanismen abgeschlossen wird.
Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.
| Wert | Bedeutung |
|---|---|
|
Einer der Parameter ist ungültig. |
|
Ein in WinError.h definierter Systemfehlercode . |
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista, Windows XP mit SP2 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | http.h |
| Bibliothek | Httpapi.lib |
| DLL | Httpapi.dll |