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

By using registry entries and by using code, the UPnP Device Host API can determine which devices to create and make available on the network. For more information about all device registration options, see Registering a Hosted Device.

For examples of the registry settings in the table below, see UPnP Registry Device Creation Sample.

Every device registered with the Device Host API using the registry requires its own key under the HKEY_CURRENT_USER\COMM\UPnPDeviceskey. For example, a device might have registry settings at HKEY_CURRENT_USER\COMM\UPnPDevices\MyDevice.

The keys under HKEY_CURRENT_USER\COMM\UPnPDevicesare only processed when the target device boots. Any changes made while the target device runs are not reflected until the target device is rebooted.

The following table shows the registry values for each device.

Value: type Description

InitString: REG_SZ

No default value.

Initialization string passed to the IUPnPDeviceControl::Initializemethod exposed by the COM object referenced by the ProgId entry.

LifeTime: REG_DWORD

No default value.

Number of seconds between successive device advertisment messages.

ProgId: REG_SZ

No default value.

ProgID of the COM object that implements the device.

State: REG_DWORD

Default not set in the registry. If the value is not present in the registry, the device is disabled (0).

Device enable/disable state. The following values are valid:

  • 0 - The device is disabled and won't be registered when the device boots.

  • 2 - The device is enabled and will be registered automatically when the device boots.

XMLDescFile: REG_SZ

No default value.

Path to device description document.

See Also