tfDeleteCommunity
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.
| 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.