Aw create resolved
|Added in version 2.1|
int aw_create_resolved (unsigned long address, int port, void **instance)
Same as aw_create, except it takes an already resolved address for the universe server.
This method presents a fully asynchronous way of creating instances (apart from when aw_create connects to an address in dotted quad form). It is up to the application to do hostname-to-address resolution. Which means it can employ an asynchronous method for doing so (e.g. WSAAsyncGetHostByName).
The universe server must be running version 2.1 or later to accept connections from SDK applications.
See aw_create for more information.
- IP address, must be in network byte order (i.e. most significant byte is stored first in memory).
- May be specified as 0 to take the default port. The default is port 6670 for v4.1 or newer, and port 5670 for v3.6 or older.
- Pointer to where an instance pointer is returned. May be specified as NULL if it is not desired.
- RC_SUCCESS (1)
- RC_NOT_INITIALIZED (1)
- WSAECONNRESET (1) (2)
- Connection was reset by universe.
- RC_TIMEOUT (2)
- Connection attempt timed out, connection was reset by universe, or handshake timed out.
- RC_NO_CONNECTION (2)
- Connection was reset by universe while waiting for handshake to succeed.
(1) Possible return values when a callback is installed.
(2) Automatic reconnection attempt in 20 seconds. Provided that aw_wait is called.
unsigned long my_resolve (char *hostname); int rc; rc = aw_create_resolved (my_resolve ("auth.activeworlds.com"), 0, NULL); if (rc != RC_SUCCESS) printf ("Unable to create a bot (reason %d)\n", rc);