Compaq AAR04BCTE manual Esnmpregstate

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_	The registration is
	PENDING	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_	The registration was
	REGDUP	rejected by the master
		agent because it was a
		duplicate.
	ESNMP_REG_STATE_	The master agent does
	REGNOCLU	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–8eSNMP API Routines