ApplyModelFromFile

virtual void ITopController::ApplyModelFromFile(const std::string &filename, const std::vector<PSubController> &subControllers) = 0

Replaces the specified sub-controllers with new instances based on the model contained in the XML controller description file.

Parameters

• filename – String containing the path to a file containing the XML controller description that contains the model to apply to the specified sub-controllers.

• subControllers – Vector of sub-controllers that the XML model should be applied on.

Throws

• CInvalidFormatException – Invalid XML contents (see exception message for details).

• CInvalidOperationException – Top-controller state is not “Config”.

• CAccessDeniedException – Unable to open file for reading.

• CReadErrorException – Error while reading from the specified file.

• CCommunicationErrorException – Protocol error.

• CConnectionLostException – Connection to controller lost.

• CRebootedException – Controller has been rebooted since this object reference was retrieved, invalidating this reference.

• CIncompatibleException – Incompatible firmware version loaded.

• CObjectDestroyedException – Object is destroyed.