CONFIGMG_Remove_SubTree

CONFIGRET CONFIGMG_Remove_SubTree(DEVNODE dnAncestor, ULONG ulFlags)

Removes a device node and its children.

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

dnAncestor

Handle of the device node that is being removed.

ulFlags

Must be zero.

Configuration Manager notifies each device node in the subtree of the dnAncestor parameter of its imminent termination and then, if possible, frees the device nodes. If a PCMCIA SCSI card were removed, for example, the PCMCIA driver would use this function to remove the entire subtree from the hardware tree.

See also CONFIGMG_Query_Remove_SubTree