eSNMP API Routines
esnmp_register2
Field Name
Description
range_upper_bound
An integer value that, with a nonzero range_subid
field, specifies a range instead of one of the MIB
subtree’s OID subidentifiers. The range_upper_bound
field provides the upper bound of the range and the
range_subid field provides the lower bound of the
range, which is the MIB subtree’s OID subidentifier.
options
An integer value that, when set to
ESNMP_REG_OPT_CLUSTER, indicates that the
registration is valid clusterwide. When the value is set
to zero, it indicates that the registration is valid for the
local node.
state
One of the following integer values that provides
the caller with asynchronous updates of the state of
registration of this MIB subtree. After the return of
the
esnmp_poll
routine, the caller can inspect this
parameter.
ESNMP_REG_STATE_
PENDING
The registration is
currently held locally
while waiting for
connection to the
master agent.
ESNMP_REG_STATE_SENT
The registration was
sent to the master
agent.
ESNMP_REG_STATE_DONE
The registration
was successfully
acknowledged by
the master agent.
ESNMP_REG_STATE_
REGDUP
The registration was
rejected by the master
agent because it was a
duplicate.
ESNMP_REG_STATE_
REGNOCLU
The master agent does
not support cluster
registrations.
ESNMP_REG_STATE_REJ
The master agent
rejected the
registration for other
reasons.
reserved
This field is reserved for exclusive use by the eSNMP
library. The caller should not modify it.
Description
The initialization routine (
esnmp_init
) must be called prior to calling the
esnmp_register2
routine. The
esnmp_register2
function must be called for each
subtree structure corresponding to each MIB subtree that it will be handling. At
any time, MIB subtrees can be unregistered by calling
esnmp_unregister2
and
then can be reregistered by calling
esnmp_register2
.
5–8 eSNMP API Routines
