HttpCreateServerSession, fonction (http.h)

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 une instance de la structure et définissez-la sur la valeur prédéfinie HTTPAPI_VERSION_2 avant de la transmettre à HttpCreateServerSession.

La version doit être 2.0 ; HttpCreateServerSession ne prend pas en charge les files d’attente de requêtes 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 non prise en charge.
ERROR_INVALID_PARAMETER
Le paramètre pServerSessionId est null ou le paramètre Réservé n’est pas 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 eux. 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 de serveur.

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

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