IUPnPRegistrar::RegisterRunningDevice

  • Article

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.

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

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Upnphost.h.
Link Library: Uuid.lib.

See Also

IUPnPDeviceControl | IUPnPDeviceControl::Initialize

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.