Fonction HttpFlushResponseCache (http.h)

La fonction HttpFlushResponseCache supprime du cache d’API du serveur HTTP associé à une file d’attente de requêtes donnée tous les fragments de réponse qui ont un nom dont la partie site correspond à un UrlPrefix spécifié. L’application doit avoir précédemment appelé HttpAddUrl ou HttpAddUrlToUrlGroup pour ajouter ce urlPrefix ou un préfixe valide de celui-ci à la file d’attente de requêtes en question, puis appelé HttpAddFragmentToCache pour mettre en cache le ou les fragments de réponse associés.

Syntaxe

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

Paramètres

[in] RequestQueueHandle

Gérez la file d’attente de requêtes à laquelle ce cache est associé. Une file d’attente de requêtes est créée et son handle est retourné par un appel à la fonction HttpCreateRequestQueue .

Windows Server 2003 avec SP1 et Windows XP avec SP2 : Le handle de la file d’attente de requête est créé par la fonction HttpCreateHttpHandle .

[in] UrlPrefix

Pointeur vers une chaîne UrlPrefix pour correspondre à la partie de site des noms de fragments. L’application doit avoir précédemment appelé HttpAddUrl pour ajouter ce UrlPrefix ou un préfixe valide de celui-ci à la file d’attente de requêtes en question, puis appelé HttpAddFragmentToCache pour mettre en cache le fragment de réponse associé.

[in] Flags

Ce paramètre peut contenir l’indicateur suivant :

HTTP_FLUSH_RESPONSE_FLAG_RECURSIVE

Entraîne la suppression des fragments de réponse qui ont des noms dans lesquels la partie site est un descendant hiérarchique de l’UrlPrefix spécifié du cache de fragments, en plus de ces fragments ayant des parties de site qui correspondent directement.

[in] Overlapped

Pour les appels asynchrones, définissez pOverlapped pour qu’il pointe vers une structure CHEVAUCHEMENT OU , pour les appels synchrones, définissez-la sur NULL.

Un appel synchrone se bloque jusqu’à ce que l’opération de cache soit terminée, tandis qu’un appel asynchrone retourne immédiatement ERROR_IO_PENDING et que l’application appelante utilise alors les ports getOverlappedResult ou d’achèvement d’E/S pour déterminer quand l’opération est terminée. Pour plus d’informations sur l’utilisation des structures OVERLAPPED pour la synchronisation, consultez Synchronisation et entrées et sorties qui se chevauchent.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR.

Si la fonction est utilisée de manière asynchrone, une valeur de retour de ERROR_IO_PENDING indique que la demande de cache est mise en file d’attente et se termine ultérieurement par le biais de mécanismes d’achèvement d’E/S qui se chevauchent normalement.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.

Valeur	Signification
ERROR_INVALID_PARAMETER	L’un des paramètres n’est pas valide.
Autres	Code d’erreur système défini dans WinError.h.

Configuration requise

Client minimal pris en charge	Windows Vista, Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	http.h
Bibliothèque	Httpapi.lib
DLL	Httpapi.dll

Voir aussi

Fonctions API de serveur HTTP version 1.0

HttpAddFragmentToCache

HttpReadFragmentFromCache