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.

Anforderungen

Weitere Informationen

Funktionen der HTTP-Server-API, Version 1.0

HttpAddFragmentToCache

HttpReadFragmentFromCache