Méthode IWSDServiceProxy ::SubscribeToOperation (wsdclient.h)

Article
03/04/2024

S’abonne à un événement de notification ou de sollicitation/réponse.

Syntaxe

HRESULT SubscribeToOperation(
  [in]  const WSD_OPERATION  *pOperation,
  [in]  IUnknown             *pUnknown,
  [in]  const WSDXML_ELEMENT *pAny,
  [out] WSDXML_ELEMENT       **ppAny
);

Paramètres

[in] pOperation

Référence à une structure WSD_OPERATION qui spécifie l’opération à laquelle s’abonner.

[in] pUnknown

Données anonymes transmises à une fonction de rappel d’événements client. Ces données sont utilisées pour associer un objet client à l’abonnement.

[in] pAny

Données extensibles à ajouter au corps de la demande d’abonnement. Vous pouvez utiliser les interfaces IWSDXML* pour générer les données. Pour plus d’informations, consultez WSDXML_ELEMENT.

[out] ppAny

Données extensibles que l’appareil distant peut ajouter à la réponse de l’abonnement. Cela permet aux services de fournir une personnalisation supplémentaire des abonnements aux événements. Lorsque vous avez terminé, appelez WSDFreeLinkedMemory pour libérer la mémoire. Pour plus d’informations, consultez WSDXML_ELEMENT. Ne relâchez pas cet objet.

Valeur retournée

Les valeurs de retour possibles incluent, sans s’y limiter, les éléments suivants :

Code de retour	Description
S_OK	Méthode terminée avec succès.
E_INVALIDARG	Le proxy s’est déjà abonné à l’opération spécifiée par pOperation.
E_OUTOFMEMORY	Mémoire insuffisante pour terminer l’opération.
E_FAIL	La méthode a échoué.

Remarques

Cette méthode est normalement appelée uniquement par le code proxy généré.

Configuration requise

Condition requise	Valeur
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	wsdclient.h (inclure Wsdapi.h)
DLL	Wsdapi.dll

Voir aussi

IWSDServiceProxy

Partager via