CM_Setup_DevNode function (cfgmgr32.h)
The CM_Setup_DevNode function restarts a device instance that is not running because there is a problem with the device configuration.
Syntax
CMAPI CONFIGRET CM_Setup_DevNode(
[in] DEVINST dnDevInst,
[in] ULONG ulFlags
);
Parameters
[in] dnDevInst
A device instance handle that is bound to the local system.
[in] ulFlags
One of the following flag values:
CM_SETUP_DEVNODE_READY
Restarts a device instance that is not running because of a problem with the device configuration.
CM_SETUP_DEVNODE_RESET (Windows XP and later versions of Windows)
Resets a device instance that has the no restart device status flag set. The no restart device status flag is set if a device is removed by calling CM_Query_And_Remove_SubTree or CM_Query_And_Remove_SubTree_Ex and specifying the CM_REMOVE_NO_RESTART flag.
Return value
If the operation succeeds, the function returns CR_SUCCESS. Otherwise it returns one of the error codes with "CR_" prefix that are defined in Cfgmgr32.h.
Remarks
Device installation applications should use the DIF_PROPERTYCHANGE request to restart a device instead of using this function. The DIF_PROPERTYCHANGE request can be used to enable, disable, restart, stop, or change the properties of a device.
If a device instance does not have a problem and is already started, CM_Setup_DevNode returns without changing the status of the device instance.
Call CM_Get_DevNode_Status or CM_Get_DevNode_Status_Ex to determine the status and problem code for a device instance.
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 |