Aw license previous

From ActiveWiki
Jump to navigation Jump to search


Minimum requirements
Added in version 2.1
SDKbuild 13


int aw_license_previous (void)

Description

Returns attributes of the previous world license in the license database.

Callback

AW_CALLBACK_LICENSE_ATTRIBUTES

Notes

The license with the previous name alphabetically before the current value of AW_LICENSE_NAME is returned.

Arguments

None

Argument attributes

AW_LICENSE_NAME

Return values

RC_SUCCESS (1) (2)
RC_NOT_INITIALIZED (1)
RC_NO_INSTANCE (1)
RC_NO_CONNECTION (1)
The connection to the universe is down.
RC_NOT_AVAILABLE (1)
Instance must be owned by the root account (citizen #1 - universe administrator).
RC_UNAUTHORIZED (2)
Instance must be owned by the root account (citizen #1 - universe administrator).
RC_NO_SUCH_LICENSE (2)

(1) Possible return values when a callback is installed.

(2) Returned by the universe server.

Returned attributes

AW_LICENSE_ALLOW_TOURISTS
AW_LICENSE_COMMENT
AW_LICENSE_CREATION_TIME
AW_LICENSE_EMAIL
AW_LICENSE_EXPIRATION_TIME
AW_LICENSE_HIDDEN
AW_LICENSE_LAST_ADDRESS
AW_LICENSE_LAST_START
AW_LICENSE_NAME
AW_LICENSE_PASSWORD
AW_LICENSE_PLUGINS
AW_LICENSE_RANGE
AW_LICENSE_USERS
AW_LICENSE_VOIP

Usage

Print the names of the universe's ten last licenses.

int i;

aw_string_set (AW_LICENSE_NAME, "\xff"); /* ascii code 255 */

for (i = 0; i < 10; i++)
{
  if (aw_license_next () != RC_SUCCESS)
    break;
  printf ("%s\n", aw_string (AW_LICENSE_NAME));
}

See also