Extension-Agent Implementor APIs

All SNMP Get and Set operations that are developer-generated must conform to the subroutine call signature that is shown in the following code example.

UINT fn_somefunction (
  UINT actionId,
  AsnAny *objectArray,
  UINT *errorIndex
);

The subroutine call signature parameters are the following:

  • actionId
    In.

    The request type that is passed in to the SnmpExtensionQuery call. This is the SNMP request that the master agent passes on to the extension agent. This parameter can be one of the values that are defined by SNMPv2c.

  • ObjectArray
    In/out.

    A pointer to an array of AsnAny variables that represent the variable or variables to be acted on in this routine.

  • ErrorIndex
    Out.

    A pointer to the return-error index.

The subroutine call signature return values are as follows:

  • The Snmpv1 or Snmpv2c error code to be returned to the SNMP manager as a result of processing this variable.
  • The routines that are defined with the subroutine call signature are the extension-agent implementor-generated worker routines. The framework calls these routines to process a Get or Set request on an SNMP variable.

See Also

SnmpTfx Framework

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.