IWSDServiceProxyEventing::SubscribeToMultipleOperations method (wsdclient.h)

Subscribes to a collection of notifications or solicit/response events.

Syntax

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
);

Parameters

[in] pOperations

Pointer to an array of references to WSD_OPERATION structures that specify the operations of whiCh to subscribe.

[in] dwOperationCount

The number of elements in the array in pOperations.

[in] pUnknown

Anonymous data passed to a client eventing callback function. This data is used to associate a client object with the subscription.

[in] pExpires

Pointer to a WSD_EVENTING_EXPIRES structure that specifies requested duration for the subscription.

[in] pAny

Pointer to extensible data to be added to the body of the request. This parameter is optional.

[out] ppExpires

Pointer to a pointer to a WSD_EVENTING_EXPIRES structure that specfies the duration of the subscription. Upon completion, call WSDFreeLinkedMemory to free the memory. This parameter is optional.

[out] ppAny

Extensible data that the remote device can add to the subscription response. This allows services to provide additional customization of event subscriptions. When done, call WSDFreeLinkedMemory to free the memory. For details, see WSDXML_ELEMENT. This parameter is optional.

Return value

Possible return values include, but are not limited to, the following:

Return code Description
S_OK
Method completed successfully.
E_INVALIDARG
The proxy has already subscribed to the operation specified by pOperation.
E_OUTOFMEMORY
Insufficient memory to complete the operation.
E_FAIL
The method failed.

Remarks

This method is designed to be exclusively called by generated proxy code.

The method is synchronous and will return when the requests have completed or the expiration criteria have been satisfied.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header wsdclient.h (include Wsdapi.h)
DLL Wsdapi.dll

See also

IWSDServiceProxyEventing