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 |
|---|---|
|
L’application appelante n’a pas appelé HttpInitialize avant d’appeler cette fonction. |
|
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 |