HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_SECURITY_ACCESS_LIST
buffer. The num_last_users parameter indicates how many user name structures have been returned;
the application can issue further verbs to obtain the remaining data.
AP_NO
The data for the last list is complete.
Each entry in the data buffer consists of the following:
security_access_detail.list_name
The name of the security access list. This is an ASCII string of 1–14 characters.
security_access_detail.num_filtered_users
The total number of user names in this security access list.
security_access_detail.def_data.description
A null-terminated text string describing the security access list, as specified in the definition of the list.
security_access_detail.def_data.num_users
The total number of users in the security access list.
If this is the last list in the data buffer, and the last_list_incomplete parameter is set to
AP_YES, the total
number of user name structures returned for this list will be as specified by the num_last_users parameter;
this will be less than num_users.
For each user name in the list, a
security_user_data structure is returned with the following information:
user_name
Name of the user. This is a user ID defined using the DEFINE_USERID_PASSWORD verb.
3.156.4 Returned Parameters: Parameter Check
If the verb does not execute because of a parameter error, SNAplus2 returns the following parameters:
primary_rc
AP_PARAMETER_CHECK
secondary_rc
Possible values are:
AP_INVALID_LIST_NAME
The list_options parameter was set to AP_LIST_INCLUSIVE, but the list_name parameter did not
match the name of any defined security access list.
AP_INVALID_USER_NAME
The list_options parameter was set to AP_LIST_INCLUSIVE, but the user_name parameter did not
match a user name defined for the specified security access list.
AP_INVALID_LIST_OPTION
The list_options parameter was not set to a valid value.
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_PARAMETER_CHECK,
which are common to all NOF verbs.
3.156.5 Returned Parameters: Other Conditions
Appendix B, Common Return Codes lists further combinations of primary and secondary return codes that are
common to all NOF verbs.
644