int aw_server_admin (char* world_domain, int world_port, char* password, void** instance)

DESCRIPTION

Creates an administration mode bot instance associated with the specified world server.

CALLBACK

AW_CALLBACK_ADMIN

NOTES

This method is new in Active Worlds 3.1 and requires at least SDK build 18 and world server build 28. 

The world_domain or world_port may be specified as 0 to take the defaults of "localhost" and 7777 respectively. Setting world_domain to 0 or "localhost" implies a connection to a world server that is running on the same machine as the SDK application.  In this case, password is not required so it may be set to 0 (or NULL.)

If world_domain is set to an explicit domain name or IP address, then password must be specified.  World servers will not accept administration mode connections from other hosts without a password.  The administration mode password for a world server is set in the server's world.ini file:

[server]
password=myadminpw

Note that in order to accept administration mode connections from other hosts, a password must be set in the world.ini file. If no administration mode password is set, the world server will only accept administration mode connections from localhost.

The instance pointer may also be specified as 0 if no instance pointer is desired.

The world  server must be running version 3.1 or later to accept administration mode connections.

EXAMPLE

int		rc;
void*           instance;

if (rc = aw_server_admin (0, 0, 0, &instance))
  printf ("Unable to connect to local server (reason %d)\n", rc);

SEE ALSO

aw_server_world_add
aw_server_world_change
aw_server_world_delete
aw_server_world_list
aw_server_world_set
aw_server_world_start
aw_server_world_stop
aw_destroy
aw_create