int aw_enter (char* world)

DESCRIPTION

Enters a world.  The current world, if any, is automatically exited.

CALLBACK

AW_CALLBACK_ENTER

NOTES

The prototype for this function has changed with Version 3.1.  Previous versions had a second avatars argument which is now obsolete (it is now always 50.) Existing SDK applications that call aw_enter will have to be changed to remove this second argument.

The event AW_EVENT_WORLD_ATTRIBUTES will be triggered by a successful call to aw_enter. In a synchronous call to aw_enter, all the world attributes will be available after the successful completion of the call.

EXAMPLE

int		rc;

if (rc = aw_enter ("aw")) {
  printf ("Unable to enter world (reason %d)\n", rc);
  return;
}
puts (aw_string (AW_WORLD_WELCOME_MESSAGE));

SEE ALSO

aw_exit