Share via

IUPnPDeviceControl::GetServiceObject (Windows Embedded CE 6.0)

  • Article

1/6/2010

This method is used to retrieve a pointer to an IDispatch interface to the service object referenced by the device host.

Syntax

HRESULT GetServiceObject(
  BSTR bstrUDN,
  BSTR bstrServiceId,
  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 Value

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

Header upnphost.h
Library uuid.lib
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

IUPnPDeviceControl