Configuration Manager Return Values

Configuration Manager functions return a CONFIGRET value. CONFIGRET is defined as either 16- or 32-bit, depending on the compiler option; 16-bit code returns a 16-bit value and 32-bit code returns a 32-bit value.

Configuration Manager functions return CR_SUCCESS when they are successful. Otherwise, they return one of the following values.

Value Meaning
CR_ALREADY_SUCH_DEVNODE Specified device node already exists
CR_BUFFER_SMALL The operation succeeded, but the specified buffer was too small
CR_CREATE_BLOCKED Flags specifies that the devnode should not be created
CR_DEFAULT Return the default result
CR_DEVICE_NOT_THERE Driver could not find device
CR_DEVLOADER_NOT_READY Device loader was not ready
CR_DEVNODE_HAS_REQS Device node already has requirements
CR_DLVXD_NOT_FOUND Dynamically loadable VxD was not found
CR_FAILURE Failure (Arbitrator/Enumerator)
CR_INTERRUPTS_DISABLED Interrupts were disabled
CR_INVALID_API The function cannot be called from ring 3
CR_INVALID_ARBITRATOR Arbitrator's registration identifier is invalid or there is already such a global arbitrator
CR_INVALID_DATA ISA data is invalid
CR_INVALID_DEVICE_ID Length of device identifier is greater than MAX_DEVICE_ID_LEN
CR_INVALID_DEVNODE Device node is invalid
CR_INVALID_FLAG Flags parameter is invalid
CR_INVALID_LOAD_TYPE Load type is greater than MAX_DLVXD_LOAD_TYPE
CR_INVALID_LOG_CONF Logical configuration is invalid
CR_INVALID_NODELIST Nodelist header is invalid
CR_INVALID_POINTER Specified pointer is invalid
CR_INVALID_PRIORITY Priority number>MAX_LCPRI
CR_INVALID_RANGE End range less than start range
CR_INVALID_RANGE_LIST Range list not valid
CR_INVALID_RES_DES Resource descriptor is invalid
CR_INVALID_RESOURCEID The resource identifier is ResType_All
CR_NEED_RESTART The config handler could not dynamically start the device, but will be able too the next boot
CR_NO_ARBITRATOR Resource has no arbitrator
CR_NO_MORE_HW_PROFILES No more hardware profiles
CR_NO_MORE_LOG_CONF No more logical configurations
CR_NO_MORE_RES_DES No more resource descriptors
CR_NO_REGISTRY_HANDLE Operation will not produce registry entry
CR_NO_SUCH_DEVNODE Device node could not be located
CR_NO_SUCH_LOGICAL_DEV Logical device not found in ISAPNP conversion
CR_NO_SUCH_VALUE Registry value does not exist
CR_NOT_DISABLEABLE That devnode cannot be disable right now
CR_NOT_SYSTEM_VM The service must be coming from the system VM
CR_OUT_OF_MEMORY Out of memory
CR_REGISTRY_ERROR Registry failed
CR_REMOVE_VETOED The hardware tree should not be removed
CR_WRONG_TYPE Registry value is of other type