IUPnPRegistrar::UnregisterDevice

This method unregisters the device from the device host framework. It allows the device to be temporarily or permanently unregistered.

UnregisterDevice(
  BSTR bstrDeviceIdentifier, 
  BOOL fPermanent
);

Parameters

• bstrDeviceIdentifier
  [in] Specifies the identifier returned from a call to IUpnPRegistrar::RegisterDevice or IUPnPRegistrar::RegisterRunningDevice.
• fPermanent
  [in] Specifies a flag that is set to determine whether the device should be deleted permanently (TRUE) or not (FALSE).

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.

Remarks

This method disconnects a device from the device host if the fPermanent parameter is set to TRUE. This method permanently deletes the device. If the flag is set to FALSE, this method continues to map the device identifier with the UDN of the device that was generated by the device host.

Requirements

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

See Also

IUpnPRegistrar::RegisterDevice | IUPnPRegistrar::RegisterRunningDevice

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.