IUPnPRegistrar::RegisterRunningDevice

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method registers a running device with the device host framework and returns a device identifier that must be used to unregister or reregister the device. After being registered with the device host framework, the device is published on the network.

Syntax

RegisterRunningDevice(
  BSTR bstrXMLDesc,
  IUnknown* punkDeviceControl,
  BSTR bstrInitString,
  BSTR bstrResourcePath,
  LONG nLifeTime,
  BSTR* pbstrDeviceIdentifier
);

Parameters

• bstrXMLDesc
  [in] Specifies the XML device description template.

• punkDeviceControl
  [in] Specifies a pointer to an IUnknown interface to the device's device control class.

• bstrInitString
  [in] Specifies the device-specific initialization string that gets passed to the IUPnPDeviceControl::Initialize method.

• bstrResourcePath
  [in] Specifies the location of the resource directory of the device. This resource directory contains the icon files and service descriptions that are specified in the device description template.

• nLifeTime
  [in] Specifies the SSDP timeout (in seconds) of the device after which the announcements will be refreshed.

• pbstrDeviceIdentifier
  [out] Pointer to the device identifier that will be used to unregister or reregister the device.

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.

Requirements

See Also

Reference

IUPnPDeviceControl
IUPnPDeviceControl::Initialize