eSNMP API Routines
*_set Routine
*_set Routine
The
*_set
method routine for a 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_set ( METHOD *method );
Arguments
method
A pointer to a METHOD structure that contains the following fields:
Field Name Description
action One of ESNMP_ACT_SET,
ESNMP_ACT_UNDO, or ESNMP_ACT_
CLEANUP.
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 as serial_num. New SNMP requests
are indicated by a new value of serial_num.
varbind A pointer to the VARBIND structure that
contains the MIB variable’s supplied data value
and name (OID). The instance information has
already been extracted from the OID and placed
in the method->row->instance field.
object A pointer to the object table entry for
the MIB variable being referenced. The
method->object->object-index field is this
object’s unique index within the object table
(useful when one method routine services many
objects).
The method->object->oid field is the OID
defined for this object in the MIB.
flags A read-only integer bitmask set by the
libesnmp
routine. If set, the ESNMP_FIRST_
IN_ROW bit indicates that this call is the first
object to be set in the row. If set, the ESNMP_
LAST_IN_ROW bit indicates that this call
is the last object to be set in the row. Only
METHOD structures with the ESNMP_LAST_
IN_ROW bit set are passed to the method
routines for commit, undo, and cleanup phases.
5–22 eSNMP API Routines