Méthode IWSDServiceProxyEventing::SubscribeToMultipleOperations (wsdclient.h)

Article
08/28/2023

S’abonne à une collection de notifications ou d’événements de sollicitation/réponse.

Syntaxe

HRESULT SubscribeToMultipleOperations(
  [in]  const WSD_OPERATION        *pOperations,
  [in]  DWORD                      dwOperationCount,
  [in]  IUnknown                   *pUnknown,
  [in]  const WSD_EVENTING_EXPIRES *pExpires,
  [in]  const WSDXML_ELEMENT       *pAny,
  [out] WSD_EVENTING_EXPIRES       **ppExpires,
  [out] WSDXML_ELEMENT             **ppAny
);

Paramètres

[in] pOperations

Pointeur vers un tableau de références à WSD_OPERATION structures qui spécifient les opérations de whiCh à abonner.

[in] dwOperationCount

Nombre d’éléments dans le tableau dans pOperations.

[in] pUnknown

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

[in] pExpires

Pointeur vers une structure WSD_EVENTING_EXPIRES qui spécifie la durée demandée pour l’abonnement.

[in] pAny

Pointeur vers des données extensibles à ajouter au corps de la requête. Ce paramètre est facultatif.

[out] ppExpires

Pointeur vers un pointeur vers une structure WSD_EVENTING_EXPIRES qui indique la durée de l’abonnement. Une fois l’opération terminée, appelez WSDFreeLinkedMemory pour libérer la mémoire. Ce paramètre est facultatif.

[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. Ce paramètre est facultatif.

Valeur renvoyée

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

Code de retour	Description
S_OK	La méthode s’est 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	Échec de la méthode.

Remarques

Cette méthode est conçue pour être appelée exclusivement par le code proxy généré.

La méthode est synchrone et retourne une fois que les demandes sont terminées ou que les critères d’expiration ont été satisfaits.

Spécifications


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

Voir aussi

IWSDServiceProxyEventing

Partager via