WsCreateServiceHost, fonction (webservices.h)

Article
03/03/2024

Crée un hôte de service pour les points de terminaison spécifiés.

Syntaxe

HRESULT WsCreateServiceHost(
                 const WS_SERVICE_ENDPOINT **endpoints,
  [in]           const USHORT              endpointCount,
                 const WS_SERVICE_PROPERTY *serviceProperties,
  [in]           ULONG                     servicePropertyCount,
                 WS_SERVICE_HOST           **serviceHost,
  [in, optional] WS_ERROR                  *error
);

Paramètres

endpoints

Tableau de structures WS_SERVICE_ENDPOINT représentant les points de terminaison de service pour lesquels créer l’hôte de service.

[in] endpointCount

Nombre de points de terminaison dans le tableau de points de terminaison .

serviceProperties

Tableau de structures WS_SERVICE_PROPERTY contenant des propriétés facultatives pour l’hôte de service.

La valeur de ce paramètre peut être NULL, auquel cas, le paramètre servicePropertyCount doit être 0 (zéro).

[in] servicePropertyCount

Nombre de propriétés dans le tableau serviceProperties .

serviceHost

En cas de réussite, un pointeur qui reçoit l’adresse du WS_SERVICE_HOST structure représentant le nouvel hôte de service.

Lorsque vous n’avez plus besoin de cette structure, vous devez la libérer en appelant WsFreeServiceHost.

[in, optional] error

Pointeur vers une structure de WS_ERROR qui reçoit des informations d’erreur supplémentaires en cas d’échec de la fonction.

Valeur retournée

Si la fonction réussit, elle retourne NO_ERROR ; sinon, il retourne un code d’erreur HRESULT.

Code de retour	Description
E_INVALIDARG	Un argument non valide est spécifié pour la création de l’hôte de service.
WS_E_QUOTA_EXCEEDED	Un quota a été dépassé.
E_OUTOFMEMORY	Mémoire insuffisante pour terminer l’opération.
Autres erreurs	Cette fonction peut renvoyer d’autres erreurs non répertoriées ci-dessus.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	webservices.h
Bibliothèque	WebServices.lib
DLL	WebServices.dll