Changes the universe attributes.

Callback

None (returns immediately)

Notes

Only instances owned by the root account (citizen #1) may use aw_universe_attributes_change.

This call returns immediately (there is no associated callback.)

The following attributes are changed:

AW_UNIVERSE_ALLOW_TOURISTS
AW_UNIVERSE_BROWSER_BETA
AW_UNIVERSE_BROWSER_MINIMUM
AW_UNIVERSE_BROWSER_RELEASE
AW_UNIVERSE_SEARCH_URL
AW_UNIVERSE_WELCOME_MESSAGE
AW_UNIVERSE_WORLD_BETA
AW_UNIVERSE_WORLD_MINIMUM
AW_UNIVERSE_WORLD_RELEASE
AW_UNIVERSE_WORLD_START

In order to propagate the changes, a successful call to aw_universe_attributes_change will immediately trigger the event AW_EVENT_UNIVERSE_ATTRIBUTES in all clients currently connected to the universe.  Use extreme caution when modifying the universe attributes! Changing the various browser number attributes may trigger instant upgrade notifications for all users.  An incorrect value can cause severe problems, including possibly forcing all users to exit the system and/or all world servers to shut down.  In general, you should always first consult Activeworlds Inc. before changing the attributes in your universe.

Example

/* change the start world for this universe */

aw_string_set (AW_UNIVERSE_WORLD_START, "welcome");
if (aw_universe_attributes_change ())
  printf ("Unable to change universe attributes");