tfDeleteCommunity

Jump to: navigation, search

Table of Contents >> SNMP Programmer's Reference


#include <trapi.h>


int tfDeleteCommunity (
int which,
ttCharPtr community
);


Function Description

This function lets the user delete a community string from the list of communities. If using the SNMP agent in trilingual mode, the communities are handled in the community table, which is part of the SNMPv3 framework.

Note Note: In trilingual mode do not use this API, use tfDeleteCommunityTableEntry() instead.


Parameters

  • which
    Community flag, either TM_READ_COMMUNITY_FLAG or TM_WRITE_COMMUNITY_FLAG.
  • community
    Existing community string to be deleted.


Returns

  • TM_ENOERROR
    Success.
  • TM_ALLOCATION_ERROR
    Failure to allocate memory for the agent global variables.
  • TM_COMMUNITY_TOOLONG
    Communityis too long.
  • TM_COMMUNITY_NOT_PRINTABLE
    Failure, Community contains unprintable characters.
  • TM_RECORD_LOCKED
    Failure, communities list is locked.
  • TM_RECORD_NOTFOUND
    Failure, community in not found.
  • TM_UNKNOWN_COMMUNITY_FLAG
    Failure, which value is undefined.
  • TM_DEFAULT_NOTDELETED
    Failure, the last community cannot be deleted.


Table of Contents >> SNMP Programmer's Reference