IUPnPDeviceControl::GetServiceObject method (upnphost.h)

The GetServiceObject method is used to obtain the IDispatch pointer to a specific service object. The device host invokes this method once per service, the first time it receives a request for a service.

Syntax

HRESULT GetServiceObject(
  [in]  BSTR      bstrUDN,
  [in]  BSTR      bstrServiceId,
  [out] IDispatch **ppdispService
);

Parameters

[in] bstrUDN

Specifies the UDN of the device.

[in] bstrServiceId

Specifies the Service ID of the service for which to obtain the pointer.

[out] ppdispService

Receives the IDispatch pointer to the service object.

Return value

When implementing this method, return S_OK if the method succeeds. Otherwise, return one of the COM error codes defined in WinError.h.

Remarks

This method is invoked by the device host when a control request or event subscription is received for a particular service.

Embedded devices are differentiated by their UDNs.

Requirements

See also

IUPnPDeviceControl

Initialize