IUPnPDeviceControl::GetServiceObject

  • Article

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

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 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.

See Also

Universal Plug and Play (UPnP)

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.