Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
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 IUnknowninterface to the device's device control class.

bstrInitString

[in] Specifies the device-specific initialization string that gets passed to the IUPnPDeviceControl::Initializemethod.

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

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

See Also