DatabaseHandle :: ActivateShadowBase - Activate Shadow Database

When running a shadow database (e.g. when workspace support is enabled) one might want to read information from the shadow database rather than from the original database. Since the shadow database contains the information including all updates made in workspaces and not yet published, the shadow database is the only place where logical consistency checks can be made.

The function switches from the original database to the shadow database and allows reading from the shadow database, i.e. all read operations are directed to the shadow database instead of the original database. This function has no effect when the shadow database feature is not enabled.

When the shadow database is activated restricted updates are possible on instances (one may not change properties that are referenced as key components).

After performing the checking or other tasks one has to deactivate the shadow database (DeactivateShadowBase()).