HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_USERID_PASSWORD
AP_UINT16 num_entries; /* number of entries */
AP_UINT16 total_num_entries; /* total number of entries */
unsigned char list_options; /* listing options */
unsigned char reserv3; /* reserved */
unsigned char user_id[10]; /* user ID */
} QUERY_USERID_PASSWORD;
typedef struct userid_info
{
AP_UINT16 overlay_size; /* size of returned entry */
unsigned char user_id[10]; /* user ID */
USERID_PASSWORD_CHARS password_chars; /* password characteristics */
} USERID_INFO;
typedef struct userid_password_chars
{
unsigned char description[32]; /* resource description */
unsigned char reserv2[16]; /* reserved */
AP_UINT16 profile_count; /* number of profiles */
AP_UINT16 reserv1; /* reserved */
unsigned char password[10]; /* password */
unsigned char profiles[10][10]; /* profiles */
} USERID_PASSWORD_CHARS;
3.169.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_QUERY_USERID_PASSWORD
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 user ID / password pairs for which data should be returned. To request a specific entry
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 entry in the list.
AP_LIST_INCLUSIVE
Start at the entry specified by the user_id parameter.
AP_LIST_FROM_NEXT
Start at the entry immediately following the entry specified by the user_id parameter.
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.
695