SNMP Manager Programmer's Guide

Reference Summary
SNMP Manager Programmer’s Guide–134249
9-29
Binding MIB Objects
SNMP_Bind_IP_Address()
This function associates a variable binding of type IpAddress with a packet previously
initialized with SNMP_Create_Request() or SNMP_Create_Trap().
index
A zero-based index value indicating the position into which to
bind the MIB variable in a list of variable bindings. A value of 0
binds the variable at the front of the list, 1 binds the variable into
the second position, and so forth. The order in which you assign
variable bindings to a list is irrelevant. For example, if you have
two variable bindings, you can use an index value of 1 in the first
SNMP_Bind_ call and a value of 0 in the second call to bind the
variables into the second and first positions, respectively.
instance-
count
The number of components in the instance identifier whose value
you supply in instance-components. For example, an
instance identifier of 1.2.3.4 has a component count of 4.
instance-
components
A pointer to a structure of type OIDC_T that contains the
instance identifier of the variable binding.
value
The value of the variable binding
rcode = SNMP_Bind_IP_Address(packet,
index,
instance-count,
instance-components,
value);
int SNMP_Bind_IP_Address(SNMP_PKT_T *packet,
int index,
int instance-count,
OIDC_T *instance-components,
OCTET_T *value);
rcode
A return integer indicating whether the call succeeded. A value
of 0 indicates success, and -1 indicates failure.
packet
A pointer to an initialized request or trap packet.
index
A zero-based index value indicating the position into which to
bind the MIB variable in a list of variable bindings. A value of 0
binds the variable at the front of the list, 1 binds the variable into
the second position, and so forth. The order in which you assign
variable bindings to a list is irrelevant. For example, if you have
two variable bindings, you can use an index value of 1 in the first
SNMP_Bind_ call and a value of 0 in the second call to bind the
variables into the second and first positions, respectively.