Fonction WsCreateServiceProxy (webservices.h)

Article
08/27/2023

Crée un proxy de service avec les propriétés spécifiées.

Syntaxe

HRESULT WsCreateServiceProxy(
  [in]           const WS_CHANNEL_TYPE         channelType,
  [in]           const WS_CHANNEL_BINDING      channelBinding,
  [in, optional] const WS_SECURITY_DESCRIPTION *securityDescription,
                 const WS_PROXY_PROPERTY       *properties,
  [in]           const ULONG                   propertyCount,
                 const WS_CHANNEL_PROPERTY     *channelProperties,
  [in]           const ULONG                   channelPropertyCount,
                 WS_SERVICE_PROXY              **serviceProxy,
  [in, optional] WS_ERROR                      *error
);

Paramètres

[in] channelType

Valeur d’énumération WS_CHANNEL_TYPE représentant le type de canal du proxy de service.

[in] channelBinding

Valeur d’énumération WS_CHANNEL_BINDING représentant la liaison de canal.

[in, optional] securityDescription

Structure WS_SECURITY_DESCRIPTION représentant la description de la sécurité.

properties

Tableau de structures WS_PROXY_PROPERTY contenant des propriétés facultatives pour le proxy de service.

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

[in] propertyCount

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

channelProperties

Tableau de structures WS_CHANNEL_PROPERTY contenant des propriétés de canal facultatives. La valeur de ce paramètre peut être NULL, auquel cas, le paramètre channelPropertyCount doit être 0 (zéro).

Note Soyez très prudent lorsque vous modifiez les valeurs par défaut de ces propriétés.

[in] channelPropertyCount

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

serviceProxy

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

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

[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 ou plusieurs arguments ne sont pas valides.
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


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

Partager via