CONFIGMG_Get_DevNode_Status

CONFIGRET CONFIGMG_Get_DevNode_Status(PFARULONG pulStatus, PFARULONG pulProblemNumber, DEVNODE dnDevNode, ULONG ulFlags)
 

Retrieves the status of a device node.

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

pulStatus

Address that receives the status flags of the device node. These flags can be a combination of the following values.

DN_DRIVER_LOADED	CONFIGMG_Register_Device_Driver has been called for this device node.
DN_ENUM_LOADED	CONFIGMG_Register_Enumerator has been called for this device node.
DN_HARDWARE_ENUM	Enumeration generates hardware identifier.
DN_HAS_MARK	CONFIGMG_Create_DevNode has failed in a call for this device node.
DN_HAS_PROBLEM	The device installer is required to resolve conflicts.
DN_LIAR	Device node reported reconfiguration falsely once.
DN_NEED_TO_CONFIG	Device node may need reconfiguration. This flag can be changed asynchronously.
DN_NEED_TO_ENUM	Device node may need reenumeration. This flag can be changed asynchronously.
DN_NOT_FIRST_TIME	Device node has received a configuration.
DN_ROOT_ENUMERATED	Device node was enumerated by the root.
DN_STARTED	Device node is currently configured.

pulProblemNumber

Address that receives an identifier indicating the problem. This identifier can be one of the following.

CM_PROB_BOOT_CONFIG_CONFLICT	Conflict in boot configuration.
CM_PROB_DEVICE_NOT_THERE	Specified device does not exist.
CM_PROB_DEVLOADER_FAILED	Device loader failed.
CM_PROB_DEVLOADER_NOT_READY	Device loader is not ready.
CM_PROB_DISABLED	Device is disabled.
CM_PROB_ENTRY_IS_WRONG_TYPE	Registry value has different type.
CM_PROB_FAILED_FILTER	Filter failed.
CM_PROB_NO_CONFIGURED	No configuration for this device.
CM_PROB_NORMAL_CONFLICT	Configuration conflict.
CM_PROB_OUT_OF_MEMORY	Out of memory.
CM_PROB_REGISTRY	Unable to access the registry.
CM_PROB_VXDLDR	Failure using the VxD loader.

dnDevNode

Device node for which the status flags are retrieved.

ulFlags

Must be zero.