Compaq AAR04BCTE - Manual (Page 78)

eSNMP API Routines
*_get Routine
*_get Routine
The *_get routine is a method routine for the specified MIB item, which is
typically a MIB group (for example, system in MIB II) or a table entry (for
example, ifEntry in MIB II).
Format
int mib-group_get ( METHOD *method ) ;
Arguments
method
A pointer to a METHOD structure that contains the following fields:
Field Name Description
action One of ESNMP_ACT_GET, ESNMP_ACT_
GETNEXT, or ESNMP_ACT_GETBULK.
serial_num An integer number that is unique to this SNMP
request. Each method routine called while
servicing a single SNMP request receives the
same value of serial_num. New SNMP requests
are indicated by a new value of serial_num.
repeat_cnt Used for GetBulk only. This value indicates
the current iteration number of a repeating
VARBIND. This number increments from 1 to
max_repetitions and is 0 (zero) for nonrepeating
VARBIND structures.
max_repetitions The maximum number of repetitions to
perform. Used for
GetBulk only. This will be 0
(zero) for nonrepeating VARBIND structures.
You can optimize subsequent processing by
knowing the maximum number repeat calls will
be made.
varbind A pointer to the VARBIND structure for
which you must fill in the OID and data
fields. Upon entry of the method routine,
the method->varbind->name field is the OID
that was requested.
Upon exit of the method routine, the
method->varbind field contains the requested
data, and the method->varbind->name field is
updated to reflect the actual instance OID for
the returned VARBIND structure.
The support routines (
o_integer , o_string ,
o_oid , and o_octet ) are generally used
to load data. The libsnmp instance2oid
routine is used to update the OID in the
method->varbind->name field.
5–20 eSNMP API Routines