snmpFreeAuthCB_v3()--SNMP Version 3 Free Authentication Control Block

 #include <qtomeapi.h>

 int snmpGet_v3(snmp_auth_cb        &my_auth_cb);

An SNMP managing application uses the snmpFreeAuthCB_v3() function to free the authentication related information about a remote or local SNMP version 3 (SNMPv3) agent.

Parameters

&my_auth_cb

(Input/Output) The address of an SNMPv3 authentication control block built by the snmpDiscover_v3() function.

Authorities

Service Program Authority

*USE

Return Value

The following are the possible return codes posted by the snmpFreeAuthCB_v3() function:

For more information, see the Simple Network Management Protocol (SNMP) Support manual.

Usage Notes

This API should be called before the manager ends or after all communication ends with an SNMP agent. It should be called for each control block that was created by the snmpDiscover_v3 function.

Related Information

• The <qtomeapi.h> file (see Header Files for UNIX^®-Type Functions)
  
  
• snmpGet()--Retrieve MIB Objects
  
  
• snmpGetnext()--Retrieve Next MIB Object
  
  
• snmpSet()--Set MIB Objects
  
  
• snmpDiscover_v3()--SNMP Version 3 Discovery
  
  
• snmpGet_v3()--Retrieve MIB Objects Using SNMP Version 3
  
  
• snmpGetnext_v3()--Retrieve Next MIB Object Using SNMP Version 3
  
  
• snmpSet_v3()--Set MIB Objects Using SNMP Version 3

Example

For examples that pertain to the SNMP manager APIs, see Using SNMP Manager APIs--Example.