HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_SECURITY_ACCESS_LIST
AP_LIST_FROM_NEXT
If a user name is specified, start at the user immediately following the specified user. If no user name
is specified, start at the first user for the specified security access list.
The list is ordered by security access list name, and then by user name within each security access list. For
more information about how the list is ordered and how the application can obtain specific entries from it,
see Section 2.7,
List Options For QUERY_* Verbs.
list_name
The name of the security access list for which information is required, or the name to be used as an index
into the list of security access lists. This parameter is ignored if list_options is set to
AP_FIRST_IN_LIST.
The name is an ASCII string of 1–14 characters, padded on the right with spaces if the name is shorter than
14 characters.
user_name
To return information starting with a specific user name for the specified security access list, set this parameter
to the user name. To return information starting at the first user name for the specified security access list,
set this parameter to 10 binary zeros.
3.156.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
primary_rc
AP_OK
buf_size
Length of the information returned in the buffer.
total_buf_size
Returned value indicating the size of buffer that would have been required to return all the list information
requested. This may be higher than buf_size.
total_num_entries
Total number of entries that could have been returned. This may be higher than num_entries.
num_entries
The number of entries actually returned. The last entry may be incomplete; this is indicated by the
last_list_incomplete parameter.
num_init_users
If the user_name parameter was set to a nonzero value, so that the information for the first security access
list in the returned data does not start with the first user in that list, this parameter indicates the number of
user name structures for this list that are included in the returned data. Otherwise, this parameter is not used.
num_last_users
If the last_list_incomplete parameter indicates that the data for the last list is incomplete, this parameter
indicates the number of user name structures for this list that are included in the returned data. (The
num_filtered_users parameter returned for this list indicates the total number of user name structures that
are available.) Otherwise, this parameter is not used.
last_list_incomplete
Specifies whether the information for the last security access list is incomplete. Possible values are:
AP_YES
The complete data for the last security access list was too large to fit in the data buffer. At least one user
name structure is included, but there are further user name structures that are not included in the data
643