Compaq AAR04BCTE - Manual (Page 103)

eSNMP API Routines
inst2ip
Description
Use the EXACT mode for evaluating an instance for Get and Set operations. For
GetNext and GetBulk operations, use the NEXT mode. When using NEXT mode,
this routine assumes that the search for data will be performed using greater
than or equal to matches.
Return Values
Carry value is 0 The routine completed successfully.
Carry value is 1 For EXACT match, an error occurred. For NEXT
match, there was a carry. (If there was a carry,
the returned ipaddr is 0.)
Examples
1. The following example converts an instance to an IP address for a Get
operation, which is an EXACT match.
#include
OID
*incoming = &method->varbind->name;
OBJECT *object = method->object;
int instLength;
unsigned int instance[6];
unsigned int ip_addr;
int
iface;
-- The instance is N.1.A.A.A.A where the A’s are the IP address--
instLength = oid2instance(incoming, object, instance, 6);
if (instLength == 6 && !inst2ip(&instance[2], 4, &ip_addr, TRUE,0)) {
iface = (int) instance[0];
}
else
return ESNMP_MTHD_noSuchInstance;
2. The following example shows a GetNext operation in which there is only
one key or in which the ipaddr value is the least significant part of the
key. This is a NEXT match; therefore, a value of 1 is passed back for the
carry value.
#include
OID
*incoming = &method->varbind->name;
OBJECT *object = method->object;
int instLength;
unsigned int instance[6];
unsigned int ip_addr;
int
iface;
-- The instance is N.1.A.A.A.A where the A’s are the IP address--
instLength = oid2instance(incoming, object, instance, 6);
iface = (instLength < 1) ? 0 :(int) instance[0];
iface += inst2ip(&instance[2], instLength - 2, &ip_addr, FALSE, 1);
3. In the following example, the search key consists of multiple parts. If
you are doing a
GetNext operation, you must find the next possible value
for the search key, so that you can perform a cascaded greater-than or
equal-to search.
eSNMP API Routines 5–45