Funzione HttpCreateHttpHandle (http.h)

Articolo
03/14/2023

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
ERROR_DLL_INIT_FAILED	L'applicazione chiamante non ha chiamato HttpInitialize prima di chiamare questa funzione.
Altri	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

Vedi anche

Funzioni API SERVER HTTP versione 1.0

HttpAddUrl

HttpCreateRequestQueue

Condividi tramite