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
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| Minimum supported server | None supported |
| Target Platform | Windows |
| Header | upnphost.h |
| DLL | Upnphost.dll |