IUPnPReregistrar::ReregisterDevice

This method reregisters the static device with the same UDN that the device host originally generated through a call to the IUPnPRegistrar::RegisterDevice and IUpnPRegistrar::RegisterRunningDevice methods.

HRESULT ReregisterDevice(
  BSTR bstrDeviceIdentifier,
  BSTR bstrXMLDesc,
  BSTR bstrProgIDDeviceControlClass,
  BSTR bstrInitString,
  BSTR bstrContainerId,
  BSTR bstrResourcePath,
  LONG nLifeTime
);

Parameters

  • bstrDeviceIdentifier
    [in] Specifies the device identifier returned by a call to the IUPnPRegistrar::RegisterDevice and IUpnPRegistrar::RegisterRunningDevice methods.
  • bstrXMLDesc
    [in] Specifies the XML device description template.
  • bstrProgIDDeviceControlClass
    [in] Specifies the ProgID of a device object that implements the IUPnPDeviceControl interface. This object must be an in-process COM server.
  • bstrInitString
    [in] Specifies the device-specific initialization string that is passed to the IUPnPDeviceControl::Initialize method.
  • bstrContainerId
    [in] Specifies a string that identifies the process group to which the device belongs. All devices with the same container identifier are contained in the same process.
  • bstrResourcePath
    [in] Specifies the location of the device's resource directory. 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.

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 | IUPnPRegistrar | IUPnPRegistrar::RegisterDevice | IUpnPRegistrar::RegisterRunningDevice

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.