HttpInitialize, fonction (http.h)

Article
02/26/2024

La fonction HttpInitialize initialise le pilote d’API serveur HTTP, le démarre, s’il n’a pas déjà été démarré, et alloue des structures de données pour l’application appelante afin de prendre en charge la création de file d’attente de réponse et d’autres opérations. Appelez cette fonction avant d’appeler d’autres fonctions dans l’API serveur HTTP.

Syntaxe

HTTPAPI_LINKAGE ULONG HttpInitialize(
  [in]      HTTPAPI_VERSION Version,
  [in]      ULONG           Flags,
  [in, out] PVOID           pReserved
);

Paramètres

[in] Version

Version HTTP. Ce paramètre est une structure HTTPAPI_VERSION . Pour la version actuelle, déclarez une instance de la structure et définissez-la sur la valeur prédéfinie HTTPAPI_VERSION_1 avant de la transmettre à HttpInitialize.

[in] Flags

Options d’initialisation, qui peuvent inclure l’une des valeurs suivantes ou les deux.

Valeur	Signification
HTTP_INITIALIZE_CONFIG	Effectuez l’initialisation pour les applications qui utilisent les fonctions de configuration HTTP, HttpSetServiceConfiguration, HttpQueryServiceConfiguration, HttpDeleteServiceConfiguration et HttpIsFeatureSupported.
HTTP_INITIALIZE_SERVER	Effectuez l’initialisation pour les applications qui utilisent l’API serveur HTTP.

[in, out] pReserved

Ce paramètre est réservé et doit être NULL.

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_INVALID_PARAMETER	Le paramètre Flags contient une valeur non prise en charge.
Autres	Code d’erreur système défini dans WinError.h.

Remarques

Appelez HttpTerminate une fois l’application terminée. Tous les indicateurs qui ont été passés à HttpInitialize dans le paramètre Flags doivent également être passés à HttpTerminate. Une application peut appeler HttpInitialize à plusieurs reprises, à condition que chaque appel à HttpInitialize soit mis en correspondance ultérieurement par un appel correspondant à HttpTerminate.

Configuration requise

Condition requise	Valeur
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

Share via