SNMP Manager Programmer's Guide

Constructing and Interpreting Packets
SNMP Manager Programmer’s Guide–134249
5-28
SNMP_Bind_String()
SNMP_Bind_String()
This function associates a variable binding of type OCTET_STRING, DisplayString,
Opaque, or NSAPADDRESS with a packet previously initialized with
SNMP_Create_Request() or SNMP_Create_Trap().
rcode
is a return integer indicating whether the call succeeded. A value of 0 indicates
success, and -1 indicates failure.
packet
is a pointer to an initialized request or trap packet.
index
is 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
is 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
is a pointer to a structure of type OIDC_T that contains the instance identifier of the
variable binding.
rcode = SNMP_Bind_String(packet,
index,
instance-count,
instance-components,
data-type,
value-length,
value,
buffer-flag);
int SNMP_Bind_String(SNMP_PKT_T *packet,
int index,
int instance-count,
OIDC_T *instance-components,
OCTET_T data-type,
int value-length,
OCTET_T *value,
int buffer-flag);