CONFIGMG_Move_DevNode

CONFIGRET CONFIGMG_Move_DevNode(DEVNODE dnFromDevNode, DEVNODE dnToDevNode, ULONG ulFlags)

Replace a root enumerated devnode by the valid non-root enumerated devnode.

• Returns CR_SUCCESS if the function is successful. Otherwise, the return value can be CR_INVALID_FLAG, CR_INVALID_DEVNODE, CR_OUT_OF_MEMORY or CR_NOT_SYSTEM_VM.

dnFromDevNode

Handle of the device node that has been root enumerated.

dnToDevNode

Handle of the device node that is a reenumeration of a root devnode.

ulFlags

Must be zero.

This function is used by the device installer when it detects that a non-root enumerate devnode is really the same as its root enumerated counterpart. This function rename the root-enumerated devnode with the new name (so that for the current session, people using CONFIGMG_Read/Write_Registry go to the appropriate place) and mark the root enumerated devnode has having a problem.