Returns attributes associated with a citizen name.
AW_CALLBACK_CITIZEN_ATTRIBUTES
If name corresponds to a valid citizen, one or more of the following attributes are returned:
AW_CITIZEN_BETA
AW_CITIZEN_BOT_LIMIT
AW_CITIZEN_COMMENT
AW_CITIZEN_EMAIL
AW_CITIZEN_ENABLED
AW_CITIZEN_EXPIRATION_TIME
AW_CITIZEN_IMMIGRATION_TIME
AW_CITIZEN_LAST_LOGIN
AW_CITIZEN_NAME
AW_CITIZEN_NUMBER
AW_CITIZEN_PASSWORD
AW_CITIZEN_PRIVILEGE_PASSWORD
AW_CITIZEN_TOTAL_TIME
AW_CITIZEN_URL
Note that all attributes are returned only if this instance is owned by the universe root account (citizen #1). Otherwise, only AW_CITIZEN_NUMBER and AW_CITIZEN_URL are returned.
If you are using aw_citizen_attributes_by_name in asynchronous mode, you should check the value of AW_CITIZEN_NAME within the callback to verify that it is the same name that you queried. Note that this comparison should take into account that the name returned in AW_CITIZEN_NAME will reflect the actual case of the citizen name, which may be different from the case of the name you queried. For example, you may have specified the name "bob" in the original query, but in the callback AW_CITIZEN_NAME could be "Bob".
The attributes AW_CITIZEN_COMMENT, AW_CITIZEN_ENABLED, AW_CITIZEN_TOTAL_TIME, 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.
If the specified name does not exist, RC_NO_SUCH_CITIZEN will be returned and AW_CITIZEN_NUMBER will be 0.
if (aw_citizen_attributes_by_name ("Bob"))
puts ("No such citizen");
else
printf ("Bob's email address is %s\n", aw_string (AW_CITIZEN_EMAIL));
aw_citizen_attributes_by_number
aw_citizen_add
aw_citizen_change
aw_citizen_delete
aw_citizen_next
aw_citizen_previous