HP-UX SNAplus2 NOF Programmer's Guide

NOF API Verbs (QUERY Verbs)
QUERY_COS
Chapter 4560
Supplied Parameters
The application supplies the following parameters:
opcode
AP_QUERY_COS
overlay_size
For compatability with future releases of SNAplus2,
your application must use this field to determine the
exact length of the overlay structure returned, and
should not rely on the use of the sizeof() function.
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 COSs for which data should be
returned. To request data for a specific COS rather
than a range, specify the value 1. To return as many
entries as possible, specify zero; in this case, SNAplus2
will return themaximum number ofentries that canbe
accommodated in the supplied data buffer.
list_options
The position in the list of COSs from which SNAplus2
should begin to return data. Possible values are:
AP_FIRST_IN_LIST
Start at the first entry in the list.
AP_LIST_INCLUSIVE
Start at the entry specified by the
cos_name parameter.
AP_LIST_FROM_NEXT