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 |
|---|---|
|
L’un des paramètres n’est pas valide. |
|
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 |