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