Constants

This section describes constants used with Configuration Manager services.

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