HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_SECURITY_ACCESS_LIST
/* for last list is incomplete */
} QUERY_SECURITY_ACCESS_LIST;
typedef struct security_access_detail
{
AP_UINT16 overlay_size; /* size of returned entry */
unsigned char list_name[14]; /* list name */
unsigned char reserv1[2]; /* reserved */
AP_UINT32 num_filtered_users; /* number of users returned */
SECURITY_LIST_DEF def_data; /* list definition */
} SECURITY_ACCESS_DETAIL;
typedef struct security_list_def
{
unsigned char description[32]; /* description */
unsigned char reserv3[16]; /* reserved */
AP_UINT32 num_users; /* number of users in list */
unsigned char reserv2[16]; /* reserved */
} SECURITY_LIST_DEF;
typedef struct security_user_data
{
AP_UINT16 sub_overlay_size; /* reserved */
unsigned char user_name[10]; /* user name */
} SECURITY_USER_DATA;
3.156.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_QUERY_SECURITY_ACCESS_LIST
buf_ptr
A pointer to a data buffer that SNAplus2 will use to return the requested information.
buf_size
Size of the supplied data buffer.
num_entries
Maximum number of security access lists for which data should be returned. This number includes partial
security access list entries (for which a user name is specified, so that the returned data does not include the
first user name in the list).
To request data for a specific security access list rather than a range, specify the value 1. To return as many
entries as possible, specify zero; in this case, SNAplus2 will return the maximum number of entries that can
be accommodated in the supplied data buffer.
list_options
The position in the list from which SNAplus2 should begin to return data. Specify one of the following
values:
AP_FIRST_IN_LIST
Start at the first user name for the first security access list.
AP_LIST_INCLUSIVE
Start at the entry specified by the supplied security access list name and user name, or start at the first
user name for the specified security access list if no user name is specified.
642