CONFIGMG_Query_Change

CONFIGMG_Query_Change_Config

CONFIGRET CONFIGMG_Query_Change_Config(ULONG ulDock, ULONG ulSerialNo, ULONG ulFlags)

Determine if it is okay to change the current Hardware Profile.

Returns CR_SUCCESS if it is okay to change the hardware profile, CR_FAILURE if it is not okay. Otherwise, the return value can be CR_INVALID_FLAG, CR_NOT_SYSTEM_VM or CR_REGISTRY_ERROR.

ulDock

The Docking Station Identifier of the dock that the computer is attempting to connect to, 0 if unknown or if this is a request to undock.

ulSerialNo

The Docking Station Serial Number of the dock that the computer is attempting to connect to, 0 if unknown or if this is a request to undock.

ulFlags

Must be one of the following:

CM_HW_PROF_UNDOCK	The computer is attempting to undock.
CM_HW_PROF_DOCK	The computer is attempting to dock to an unidentified dock.
CM_HW_PROF_DOCK_KNOWN	The computer is attempting to dock to a known dock, which is identified by the ulDock and ulSerialNo paramters.

This function should only be called by a Plug and Play BIOS Enumerator. This function leaves some Root enumerated devnodes in an inactive state. After calling this function either CONFIGMG_Recompute_HW_Prof or CM_Fail_Change_HW_Prof must be called to return the Root enumerated devnodes to a normal state.