WsCreateServiceEndpointFromTemplate, fonction (webservices.h)

Article
08/27/2023

Routine d’assistance pour la création d’un point de terminaison de service (WS_SERVICE_ENDPOINT) à partir de modèles de stratégie.

Syntaxe

HRESULT WsCreateServiceEndpointFromTemplate(
  [in]           WS_CHANNEL_TYPE                    channelType,
  [in]           const WS_SERVICE_ENDPOINT_PROPERTY *properties,
  [in]           ULONG                              propertyCount,
  [in, optional] const WS_STRING                    *addressUrl,
  [in]           const WS_SERVICE_CONTRACT          *contract,
  [in]           WS_SERVICE_SECURITY_CALLBACK       authorizationCallback,
  [in]           WS_HEAP                            *heap,
  [in]           WS_BINDING_TEMPLATE_TYPE           templateType,
  [in]           void                               *templateValue,
  [in]           ULONG                              templateSize,
  [in]           const void                         *templateDescription,
  [in]           ULONG                              templateDescriptionSize,
  [out]          WS_SERVICE_ENDPOINT                **serviceEndpoint,
  [in, optional] WS_ERROR                           *error
);

Paramètres

[in] channelType

Valeur d’énumération WS_CHANNEL_TYPE représentant le type de canal hébergé par le point de terminaison.

[in] properties

Tableau de structures WS_SERVICE_ENDPOINT_PROPERTY contenant des propriétés pour le point de terminaison de service. (L’application doit renseigner les propriétés de canal dans la structure du modèle.)

[in] propertyCount

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

[in, optional] addressUrl

Adresse URL sur laquelle le point de terminaison doit écouter.

[in] contract

Structure WS_SERVICE_CONTRACT représentant le contrat du point de terminaison.

[in] authorizationCallback

Un rappel d’autorisation WS_SERVICE_SECURITY_CALLBACK pour le point de terminaison de service.

[in] heap

Tas à partir duquel la mémoire du point de terminaison de service est allouée en cas de retour réussi.

[in] templateType

Valeur d’énumération WS_BINDING_TEMPLATE_TYPE représentant le type de modèles utilisés pour créer le point de terminaison de service.

[in] templateValue

Structure de modèle facultative à créer et à remplir par application. Le modèle doit être cohérent avec le type de modèle d’entrée (passé dans le paramètre templateType ). Lorsque le paramètre templateValue a la valeur NULL, il équivaut à la structure de modèle correspondante initialisée à zéro.

[in] templateSize

Taille, en octets, de la structure templateValue d’entrée.

[in] templateDescription

Description de la structure du modèle (passée dans le paramètre templateValue ). Doit correspondre à templateType.

[in] templateDescriptionSize

Taille de la description du modèle.

[out] serviceEndpoint

En cas de réussite, un pointeur qui reçoit l’adresse du WS_SERVICE_ENDPOINT structure représentant le nouveau point de terminaison de service.

[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, elle retourne un code d’erreur HRESULT.

Remarques

WsCreateServiceEndpointFromTemplate crée la structure WS_SERVICE_ENDPOINT à partir des modèles de stratégie d’entrée spécifiés et d’une entrée utilisateur supplémentaire.

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

Partager via