int aw_universe_ejection_next (void)

DESCRIPTION

Looks up next blocked IP address in universe ejection database.

CALLBACK

AW_CALLBACK_UNIVERSE_EJECTION

NOTES

This method  requires at least SDK build 14 and universe server  build 22. 

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

The attribute AW_EJECTION_ADDRESS specifies the previous IP address (in network byte order.)  To scan the entire ejection database, set AW_EJECTION_ADDRESS to 0 and call aw_universe_ejection_next repeatedly until it fails.

If aw_universe_ejection_next succeeds, the following attributes are returned:

AW_EJECTION_ADDRESS The (next) blocked IP address
AW_EJECTION_CREATION_TIME When the ejection was first created *
AW_EJECTION_EXPIRATION_TIME When the ejection expires
AW_EJECTION_COMMENT Additional text information (optional) *

* These ejection attributes are new in Active Worlds 3.0 and require at least SDK build 16 and universe server build 23.

EXAMPLE

/* list all addresses currently blocked from the universe */

aw_int_set (AW_EJECTION_ADDRESS, 0);
while (!aw_universe_ejection_next ()) {
  int address;
  address = aw_int (AW_EJECTION_ADDRESS);
  printf ("%-15s %d\n", inet_ntoa (*(struct in_addr*) &address),
    aw_int (AW_EJECTION_EXPIRATION_TIME));
}

SEE ALSO

aw_universe_ejection_add
aw_universe_ejection_delete
aw_universe_ejection_lookup
aw_universe_ejection_previous