Compaq AAR04BCTE manual Ooctet, ESNMP API Routines ooctet

eSNMP API Routines o_octet

o_octet

Loads an octet value into the VARBIND structure with the appropriate type. This function does not allocate the VARBIND structure.

Format

int o_octet ( VARBIND *vb, OBJECT *obj, unsigned long value );

Arguments

vb

A pointer to the VARBIND structure that is supposed to receive the data.

If the original value in the vb field is not null, this routine attempts to free it. So if you dynamically allocate memory or issue the malloc command to allocate your own VARBIND structure, fill the structure with zeros before using it.

obj

A pointer to the OBJECT structure for the MIB variable associated with the OID in the VARBIND structure.

value

The value to be inserted into the VARBIND structure.

The real type as defined in the object structure must be one of the following; otherwise, an error is returned.

ESNMP_TYPE_OCTET_STRING	Octet string (ASN.1)
ESNMP_TYPE_IpAddress	Implicit octet string (4) (in octet form,
	network byte order)
ESNMP_TYPE_DisplayString	DisplayString (textual convention)
ESNMP_TYPE_Opaque	Implicit octet string

Return Values

ESNMP_MTHD_noError	The routine completed successfully.
ESNMP_MTHD_genErr	An error occurred.
Example

#include <esnmp.h>

#include "ip_tbl.h" <-- for ipNetToMediaEntry_type definition

VARBIND	*vb	=	method->varbind;
OBJECT	*object	=	method->object;

ipNetToMediaEntry_type *data;

:

:assume buffer and structure member assignments occur here

switch(arg) {

case I_atPhysAddress:

return o_octet(vb, object, &data->ipNetToMediaPhysAddress);

eSNMP API Routines 5–33