IUPnPRegistrar::UnregisterDevice

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

Syntax

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

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

See Also

Reference

IUPnPRegistrar::RegisterDevice
IUPnPRegistrar::RegisterRunningDevice