int aw_universe_ejection_lookup (void)

DESCRIPTION

Looks up a blocked universe IP address.

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_lookup.

The attribute AW_EJECTION_ADDRESS specifies the IP address to be queried (in network byte order.)  If the IP address is in the world ejection database, the following attributes are returned:

AW_EJECTION_ADDRESS The 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

void lookup_ejection (char* address)
{

  aw_int_set (AW_EJECTION_ADDRESS, inet_addr (address));
  if (aw_universe_ejection_lookup ())
    printf ("IP address %s is not blocked.\n", address);
  else {
    if (!aw_int (AW_EJECTION_EXPIRATION_TIME))
      printf ("%s is blocked indefinitely.\n", address);
    else
      printf ("%s will remain blocked for %d more seconds.\n",
        address, aw_int (AW_EJECTION_EXPIRATION_TIME) - time (NULL));
  }

}

SEE ALSO

aw_universe_ejection_add
aw_universe_ejection_delete
aw_universe_ejection_next
aw_universe_ejection_previous