IUPnPDeviceControl::GetServiceObject (Windows CE 5.0)
This method is used to retrieve a pointer to an IDispatch interface to the service object referenced by the device host.
HRESULT GetServiceObject(BSTRbstrUDN,BSTRbstrServiceId,IDispatch** ppdispService);
Parameters
- bstrUDN
[in] Specifies the unique device name (UDN) of the device. - bstrServiceId
[in] Specifies the service identifier of the device. - ppdispService
[out] Contains the address of the pointer to an IDispatch interface to the service interface.
Return Values
If the method succeeds, the return value is S_OK. Otherwise, the method returns one of the COM error codes that are defined in Winerror.h.
Remarks
The device host calls this method when it receives a control request for a particular service. If the service object already exists, this method returns a pointer to the existing instance; otherwise, it instantiates a new service object.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Upnphost.h.
Link Library: Uuid.lib.
Send Feedback on this topic to the authors