Funzione HttpCreateHttpHandle (http.h)
La funzione HttpCreateHttpHandle crea una coda di richieste HTTP per l'applicazione chiamante e restituisce un handle.
A partire dall'API HTTP Server versione 2.0, le applicazioni devono chiamare HttpCreateRequestQueue per creare la coda di richieste; HttpCreateHttpHandle non deve essere usato.
Sintassi
HTTPAPI_LINKAGE ULONG HttpCreateHttpHandle(
[out] PHANDLE RequestQueueHandle,
[in] ULONG Reserved
);
Parametri
[out] RequestQueueHandle
Puntatore a una variabile che riceve un handle alla coda della richiesta.
[in] Reserved
Riservato. Questo parametro deve essere zero.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è NO_ERROR.
Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.
| Valore | Significato |
|---|---|
|
L'applicazione chiamante non ha chiamato HttpInitialize prima di chiamare questa funzione. |
|
Codice di errore di sistema definito in WinError.h. |
Commenti
La coda della richiesta consente all'applicazione chiamante di ricevere richieste per url specifici. L'applicazione chiamante usa la funzione HttpAddUrl per specificare l'URL per cui deve ricevere le richieste.
Un'applicazione deve usare una singola coda di richiesta per ricevere le richieste. L'uso di più code di richiesta da un singolo processo non aumenta il tempo di risposta o la velocità effettiva.
Al termine della ricezione delle richieste, un'applicazione deve chiamare la funzione CloseHandle per chiudere l'handle.
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 |