Fonction HttpCreateServerSession (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 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 |
|---|---|
|
La version passée n’est pas valide ou n’est pas prise en charge. |
|
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