Funzione HttpFlushResponseCache (http.h)
La funzione HttpFlushResponseCache rimuove dalla cache dell'API del server HTTP associata a una determinata coda di richieste tutti i frammenti di risposta con un nome la cui parte del sito corrisponde a un urlPrefix specificato. L'applicazione deve in precedenza aver chiamato HttpAddUrl o HttpAddUrlToUrlGroup per aggiungere questo urlPrefix o un prefisso valido alla coda della richiesta in questione e quindi chiamato HttpAddFragmentToCache per memorizzare nella cache il frammento o i frammenti di risposta associati.
Sintassi
HTTPAPI_LINKAGE ULONG HttpFlushResponseCache(
[in] HANDLE RequestQueueHandle,
[in] PCWSTR UrlPrefix,
[in] ULONG Flags,
[in] LPOVERLAPPED Overlapped
);
Parametri
[in] RequestQueueHandle
Gestire la coda di richieste a cui è associata questa cache. Viene creata una coda di richieste e il relativo handle restituito da una chiamata alla funzione HttpCreateRequestQueue .
Windows Server 2003 con SP1 e Windows XP con SP2: L'handle per la coda di richieste viene creato dalla funzione HttpCreateHttpHandle .
[in] UrlPrefix
Puntatore a una stringa UrlPrefix per la corrispondenza con la parte del sito di nomi di frammento. L'applicazione deve in precedenza aver chiamato HttpAddUrl per aggiungere questo urlPrefix o un prefisso valido alla coda delle richieste in questione e quindi chiamato HttpAddFragmentToCache per memorizzare nella cache il frammento di risposta associato.
[in] Flags
Questo parametro può contenere il flag seguente:
HTTP_FLUSH_RESPONSE_FLAG_RECURSIVE
Fa sì che i frammenti di risposta con nomi in cui la parte del sito sia un discendente gerarchico del prefisso UrlPrefix specificato venga rimosso dalla cache dei frammenti, oltre a quelli con parti del sito corrispondenti direttamente.
[in] Overlapped
Per le chiamate asincrone, impostare pOverlapped in modo che punti a una struttura OVERLAPPED o per le chiamate sincrone, impostarla su NULL.
Una chiamata sincrona si blocca fino al completamento dell'operazione di cache, mentre una chiamata asincrona restituisce immediatamente ERROR_IO_PENDING e l'applicazione chiamante usa quindi le porte di completamento GetOverlappedResult o I/O per determinare quando l'operazione viene completata. Per altre informazioni sull'uso di strutture OVERLAPPED per la sincronizzazione, vedere Sincronizzazione e input e output sovrapposti.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.
Se la funzione viene usata in modo asincrono, un valore restituito di ERROR_IO_PENDING indica che la richiesta di cache viene accodata e viene completata in un secondo momento tramite normali meccanismi di completamento di I/O sovrapposti.
Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.
| Valore | Significato |
|---|---|
|
Uno dei parametri non è valido. |
|
Codice di errore di sistema definito in WinError.h. |
Requisiti
| Client minimo supportato | Windows Vista, Windows XP con SP2 [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | http.h |
| Libreria | Httpapi.lib |
| DLL | Httpapi.dll |