beautypg.com

Compaq AAR04BCTE User Manual

Page 66

background image

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