Fonction HttpCreateServerSession (http.h)

  • Article

La fonction HttpCreateServerSession crée une session de serveur pour la version spécifiée.

Syntaxe

HTTPAPI_LINKAGE ULONG HttpCreateServerSession(
  [in]  HTTPAPI_VERSION         Version,
  [out] PHTTP_SERVER_SESSION_ID ServerSessionId,
  [in]  ULONG                   Reserved
);

Paramètres

[in] Version

Structure HTTPAPI_VERSION qui indique la version de la session de serveur. Pour la version 2.0, déclarez un instance de la structure et définissez-le sur la valeur prédéfinie HTTPAPI_VERSION_2 avant de la passer à HttpCreateServerSession.

La version doit être 2.0 ; HttpCreateServerSession ne prend pas en charge les files d’attente de requêtes de la version 1.0.

[out] ServerSessionId

Pointeur vers la variable qui reçoit l’ID de la session de serveur.

[in] Reserved

Réservé. Doit être zéro.

Valeur retournée

Si la fonction réussit, elle retourne NO_ERROR.

Si la fonction échoue, elle retourne l’un des codes d’erreur suivants.

Valeur Signification
ERROR_REVISION_MISMATCH
 La version passée n’est pas valide ou n’est pas prise en charge.
ERROR_INVALID_PARAMETER
 Le paramètre pServerSessionId est null ou Reserved est différent de zéro.

Notes

Les sessions serveur possèdent un ensemble de groupes d’URL. Il s’agit de conteneurs de configuration de niveau supérieur pour les informations de configuration qui s’appliquent à tous les groupes d’URL créés sous ces derniers. Pour plus d’informations sur la configuration d’une session de serveur, consultez HttpSetServerSessionProperty.

L’API serveur HTTP ne prend pas en charge les E/S asynchrones pour les sessions serveur.

Lorsque la session serveur n’est plus nécessaire ou avant l’arrêt de l’application, l’application doit supprimer la session serveur en appelant HttpCloseServerSession. Lorsqu’une session de serveur est supprimée, tous les groupes d’URL associés sont également automatiquement supprimés.

Configuration requise

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [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 2.0

HttpCloseServerSession

HttpCreateServerSession

HttpQueryServerSessionProperty

HttpSetServerSessionProperty