CM_Disable_DevNode function (cfgmgr32.h)

The CM_Disable_DevNode function disables a device.

Syntax

CMAPI CONFIGRET CM_Disable_DevNode(
  [in] DEVINST dnDevInst,
  [in] ULONG   ulFlags
);

Parameters

[in] dnDevInst

Device instance handle that is bound to the local machine.

[in] ulFlags

Disable flags:

CM_DISABLE_UI_NOT_OK

Do not display any interface to the user if the attempt to disable the device fails.

CM_DISABLE_PERSIST

Disables the device across reboots.

Return value

If the operation succeeds, the function returns CR_SUCCESS. Otherwise, it returns one of the CR_-prefixed error codes defined in Cfgmgr32.h.

Remarks

By default, CM_Disable_DevNode disables a device at one time, but after reboot the device is enabled again. Starting in Windows 10, you can specify the CM_DISABLE_PERSIST flag to disable the device across reboots.

Requirements

Requirement Value
Minimum supported client Available in Microsoft Windows 2000 and later versions of Windows.
Target Platform Universal
Header cfgmgr32.h (include Cfgmgr32.h)
Library Cfgmgr32.lib; OneCoreUAP.lib on Windows 10
DLL CfgMgr32.dll

See also

CM_Enable_DevNode

DIF_PROPERTYCHANGE

SetupDiCallClassInstaller