CM_Disable_DevNode function (cfgmgr32.h)

Article
02/22/2024

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