int aw_citizen_change (void)

DESCRIPTION

Changes the attributes of an existing citizen.

CALLBACK

AW_CALLBACK_CITIZEN_RESULT

NOTES

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

The following attributes are changed:

AW_CITIZEN_BETA
AW_CITIZEN_BOT_LIMIT
AW_CITIZEN_COMMENT
AW_CITIZEN_EMAIL
AW_CITIZEN_ENABLED
AW_CITIZEN_EXPIRATION_TIME
AW_CITIZEN_NAME
AW_CITIZEN_PASSWORD
AW_CITIZEN_PRIVILEGE_PASSWORD
AW_CITIZEN_URL

Since all attributes are changed, all  attributes must be set to meaningful values before calling aw_citizen_change.  Note that aw_citizen_attributes_by_name, aw_citizen_attributes_by_number, aw_citizen_next, and aw_citizen_previous set these attributes automatically.

The attributes AW_CITIZEN_COMMENT, AW_CITIZEN_ENABLED, and AW_CITIZEN_URL are new in version 3.1 and require at least build 18 of the SDK and version 3.1 of the uniserver.

All citizen attributes are visible to universe administrators from the citizens dialog within the Active Worlds browser.

EXAMPLE

int		rc;

if (aw_citizen_attributes_by_number (1)) {
  puts ("No such citizen");
  return;
  }
aw_string_set (AW_CITIZEN_PASSWORD, "newpass");
if (rc = aw_citizen_change ())
  printf ("Unable to change password (reason %d)\n", rc);
else
  puts ("Password changed");

SEE ALSO

aw_citizen_attributes_by_name
aw_citizen_attributes_by_number
aw_citizen_add
aw_citizen_delete
aw_citizen_next
aw_citizen_previous