Fonction HttpCreateHttpHandle (http.h)

La fonction HttpCreateHttpHandle crée une file d’attente de requêtes HTTP pour l’application appelante et y retourne un handle.

À compter de l’API serveur HTTP version 2.0, les applications doivent appeler HttpCreateRequestQueue pour créer la file d’attente des requêtes ; HttpCreateHttpHandle ne doit pas être utilisé.

Syntaxe

HTTPAPI_LINKAGE ULONG HttpCreateHttpHandle(
  [out] PHANDLE RequestQueueHandle,
  [in]  ULONG   Reserved
);

Paramètres

[out] RequestQueueHandle

Pointeur vers une variable qui reçoit un handle dans la file d’attente des requêtes.

[in] Reserved

Réservé. Ce paramètre doit être égal à zéro.

Valeur retournée

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

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

Valeur	Signification
ERROR_DLL_INIT_FAILED	L’application appelante n’a pas appelé HttpInitialize avant d’appeler cette fonction.
Autres	Code d’erreur système défini dans WinError.h.

Notes

La file d’attente des demandes permet à l’application appelante de recevoir des demandes pour des URL particulières. L’application appelante utilise la fonction HttpAddUrl pour spécifier l’URL pour laquelle elle doit recevoir les demandes.

Une application doit utiliser une file d’attente de requêtes unique pour recevoir des demandes. L’utilisation de plusieurs files d’attente de requêtes à partir d’un même processus n’augmente pas le temps de réponse ou le débit.

Lorsqu’une application a fini de recevoir des demandes, elle doit appeler la fonction CloseHandle pour fermer le handle.

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 de l’API serveur HTTP version 1.0

HttpAddUrl

HttpCreateRequestQueue