beautypg.com

Compaq AAR04BCTE User Manual

Page 79

background image

eSNMP API Routines

*_get Routine

Field Name

Description

object

A pointer to the object table entry for
the MIB variable being referenced. The
method->object->object_index field is this
object’s unique index within the object table
(useful when one method routine services many
objects).
The method->object->oid field is the OID
defined for this object in the MIB. The
instance requested is derived by comparing
this OID with the OID in the request found
in the method->varbind->name field. The

oid2instance

function is useful for this.

Description

These types of routines call whatever routine is specified for

Get

operations in the

object table identified by the registered subtree.

This function is pointed to by some number of elements of the subagent object
table. When a request arrives for an object, its method routine is called. The

*_get

method routine is called in response to a

Get

request.

Return Values

ESNMP_MTHD_noError

The routine completed successfully.

ESNMP_MTHD_
noSuchObject

The requested object cannot be returned or does
not exist.

ESNMP_MTHD_
noSuchInstance

The requested instance of an object cannot be
returned or does not exist.

ESNMP_MTHD_genErr

A general processing error.

eSNMP API Routines 5–21