WsCall, fonction (webservices.h)

Article
08/27/2023

Utilisé en interne par le proxy de service pour mettre en forme les arguments spécifiés en fonction des métadonnées spécifiées et les envoyer dans un message. L’application ne doit jamais appeler cette fonction directement.

Syntaxe

HRESULT WsCall(
  [in]           WS_SERVICE_PROXY               *serviceProxy,
  [in]           const WS_OPERATION_DESCRIPTION *operation,
  [in, optional] const void                     **arguments,
  [in]           WS_HEAP                        *heap,
                 const WS_CALL_PROPERTY         *callProperties,
  [in]           const ULONG                    callPropertyCount,
  [in, optional] const WS_ASYNC_CONTEXT         *asyncContext,
  [in, optional] WS_ERROR                       *error
);

Paramètres

[in] serviceProxy

Pointeur vers une structure WS_SERVICE_PROXY représentant le proxy de service.

[in] operation

Pointeur vers une structure de WS_OPERATION_DESCRIPTION contenant les métadonnées de l’appel.

[in, optional] arguments

Tableau de pointeurs vers les arguments individuels de l’opération de service représentée par le paramètre d’opération .

Le nombre d’éléments doit correspondre au nombre de paramètres spécifiés dans le cadre de WS_OPERATION_DESCRIPTION dans le paramètre d’opération.

[in] heap

Pointeur vers une structure WS_HEAP représentant le tas à partir duquel la mémoire est allouée pour l’appel.

callProperties

Tableau de structures WS_CALL_PROPERTY contenant les propriétés d’appel.

[in] callPropertyCount

Nombre de propriétés dans le tableau de propriétés d’appel.

[in, optional] asyncContext

Pointeur vers les informations permettant d’appeler la fonction de manière asynchrone. Passez la valeur NULL pour appeler la fonction de manière synchrone.

[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.

Code de retour	Description
WS_E_INVALID_OPERATION	L’opération n’est pas autorisée en raison de l’état actuel de l’objet.
WS_E_QUOTA_EXCEEDED	Un quota a été dépassé.
WS_E_OPERATION_ABANDONED	L’opération a été abandonnée.
WS_E_OPERATION_TIMED_OUT	L’opération ne s’est pas terminée dans le délai imparti.
E_OUTOFMEMORY	Mémoire insuffisante pour terminer l’opération.
E_INVALIDARG	Un ou plusieurs arguments ne sont pas valides.
WS_S_ASYNC	L’opération asynchrone est toujours en attente.
Autres erreurs	Cette fonction peut retourner d’autres erreurs non répertoriées ci-dessus.

Configuration requise

Condition requise	Valeur
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