Partager via

HttpInitialize, fonction (http.h)

  • Article

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

Voir aussi