Compaq AAR04BCTE - Manual (Page 81)

eSNMP API Routines
*_set Routine
Field Name Description
row A pointer to a ROW_CONTEXT structure
(defined in the ESNMP.H header file). All
Set
requests to the method routine that refer to the
same group and that have the same instance
number will be presented with the same row
structure. The method routines can accumulate
information in the row structures during
Set
requests for use during the commit and undo
phases. The accumulated data can be released
by the method routines during the cleanup
phase.
The ROW_CONTEXT structure contains the
following fields:
instance An address of an array
containing the instance OID
for this conceptual row. The
libesnmp routine builds this
array by subtracting the
object OID from the requested
variable binding OID.
instance_len The size of the
method->row->instance field.
context A pointer to be used privately
by the method routine to
reference data needed for
processing this request.
save A pointer to be used privately
by the method routine to
reference data needed for
undoing this request.
state An integer to be used
privately by the method
routine for holding any state
information it requires.
Description
The libesnmp routines call whatever routine is specified for Set operations in the
object table identified by the registered subtree.
This function is pointed to by some number of elements of the subagent object
table. When a request arrives for an object, its method routine is called. The
*_set method routine is called in response to a Set request.
eSNMP API Routines 5–23