SNMP_PP_CHS Charpter 19 - 21
1. 运行模式
SNMP++的设计（决定了它）支持多种运行模式。这些运行模式允许（用户）创建图形用户接口（GUI）以及控制台模式的应用。GUI运行模式与现有的GUI事件（驱动）系统协同工作；而控制台运行模式允许使用自定义的事件（驱动）系统，甚至不需要事件（驱动）系统。
1.1. Microsoft Windows事件（驱动）系统的运作
为了在MS-Windows上使用，SNMP++与MS-Windows消息系统协同工作。调用阻塞模式（可以）允许处理其他消息。
1.2. Open Systems Foundation (OSF) X11 Motif的运作
X11接口与MS-Windows接口一样。在MS-Windows和X11各种版本上的SNMP++都支持阻塞和异步方式的使用。为了用SNMP++对X11应用注册X11的上下文（context）需要一个额外的函数（该操作是为了在X11的事件系统上使用SNMP++）。这就要用到XtAppMainLoop()或类似的函数来显式地认可并分发所有异步的SNMP++事件。
· The context parameter passed in is returned from a call to XtAppInitialize().
· The return value is zero if the function is successful in registering with X11.
· （需要）传入的上下文参数会由XtAppInitialize()的调用返回
· 如果对X11注册成功，则该函数返回零
//----------------[ initialize SNMP++ X11 Context ]--------------------------
int SNMPX11Initialize( XtAppContext context);
1.3. 不以GUI为基础的应用的运作
SNMP++的第三种运作模式是用文本形式构造的控制台应用。这些类型的应用上的操作也可以调用阻塞或异步的模式。SNMP++提供了一组函数调用来读取当前用到的文件描述符（socket handles）。调用者在它们各自的“select”调用中用到这些文件描述符。如果SNMP++文件描述符有一个挂起的事件，调用者将激活例行程序来处理所有挂起的事件。
SNMPGetFdSets
用以决定需要潜在地激活的文件描述符。该函数会填充读、写、异常模块，以便传递到“select”。
//-------[ get file descriptor set from SNMP++ ]------------------------------------
void SNMPGetFdSets( int &maxfds, // max # of fds represented
fd_set &read_fds, // mask representing read actions
fd_set &write_fds, // mask representing write actions
fd_set &exceptfds); // mask representing exception actions
SNMPGetNextTimeout
用以决定下次出现超时事件的时间。该值可在阻塞操作中被用作最大间隔值。比如select在控制权返回之前必须等待（该间隔时间）。超时的计算的基础是：所有用户注册超时（user-registered time-outs）以及SNMP重发的时间间隔中最近的一次。
//---------[ Get the next time-out value ]----------------------------------------------------
unsigned long int SNMPGetNextTimeout( ); // returns value in 1/100 of seconds
SNMPProcessPendingEvents
用以处理目前所有的突出的（outstanding）事件。该函数会调用所有与已完成的超时、文件描述符或突出的（outstanding）SNMP消息相关的回调。该函数是非阻塞的，在同一时候它只处理突出的（outstanding）事件。
//------[ process pending events ]----------------------------------------------------------
int SNMPProcessPendingEvents();
2. 状态＆错误编号
当使用Snmp class操作的时候SNMP++提供了两种级别的错误（信息）。所有的Snmp class成员函数都返回一个状态值。“SNMP_CLASS_ERR_STATUS_SET”这个特别的错误值表明了Pdu发生了一个内部错误，必须用成员函数Pdu::get_error_status()来检索该错误（信息）。所有的SNMP++错误值都可传进成员函数Snmp::err_msg()以打印出该错误的文本描述。
| SNMP++ General Errors |
Value |
Description
|
| SNMP_CLASS_SUCCESS |
0 |
成功状态 |
| SNMP_CLASS_ERROR |
-1 |
普通错误 |
| SNMP_CLASS_RESOURCE_UNAVAIL |
-2 |
内存分配失败（New或malloc） |
| SNMP_CLASS_INTERNAL_ERROR |
-3 |
未知的内部错误 |
| SNMP_CLASS_UNSUPPORTED |
-4 |
不支持的函数 |
| Callback Reasons |
|
|
| SNMP_CLASS_TIMEOUT |
-5 |
明显的请求超时 |
| SNMP_CLASS_ASYNC_RESPONSE |
-6 |
收到应答 |
| SNMP_CLASS_NOTIFICATION |
-7 |
收到notification (trap/inform) |
| SNMP_CLASS_SESSION_DESTROYED |
-8 |
销毁Snmp对象 |
| Snmp Class Errors
|
|
|
| SNMP_CLASS_INVALID |
-10 |
在无效的实例上调用了Snmp成员函数 |
| SNMP_CLASS_INVALID_PDU |
-11 |
向映像函数传递了无效的PDU |
| SNMP_CLASS_INVALID_TARGET |
-12 |
向映像函数传递了无效的target |
| SNMP_CLASS_INVALID_CALLBACK |
-13 |
向映像函数传递了无效的回调函数 |
| SNMP_CLASS_INVALID_REQID |
-14 |
要取消的请求ID无效 |
| SNMP_CLASS_INVALID_NOTIFYID |
-15 |
trap/inform Oid丢失 |
| SNMP_CLASS_INVALID_OPERATION |
-16 |
指定的target不允许进行Snmp操作 |
| SNMP_CLASS_INVALID_OID |
-17 |
向映像函数传递了无效的Oid |
| SNMP_CLASS_INVALID_ADDRESS |
-18 |
向映像函数传递了无效的address |
| SNMP_CLASS_ERR_STATUS_SET |
-19 |
代理端返回带有错误信息的应答PDU |
| SNMP_CLASS_TL_UNSUPPORTED |
-20 |
不支持的传输 |
| SNMP_CLASS_TL_IN_USE |
-21 |
传输被占用 |
| SNMP_CLASS_TL_FAILED |
-22 |
传输失败 |
3. 错误状态值
当SNMP++的成员函数返回值是“SNMP_CLASS_ERR_STATUS_SET”时，可以由成员函数Pdu::get_error_status()获取一个额外的错误状态。该值表示的是RFC 1905中实际的SMI PDU错误状态值。这些值可以传进成员函数Snmp::err_msg()以友好（的方式）描述。
| Pdu Error Status Macro
|
Value
|
Description |
| SNMP_ERROR_TOO_BIG |
1 |
Pdu太大，查看错误索引 |
| SNMP_ERROR_NO_SUCH_NAME |
2 |
没有对应的帮定变量名称，查看返回的错误索引 |
| SNMP_ERROR_BAD_VALUE |
3 |
错误的帮定变量，查看返回的错误索引 |
| SNMP_ERROR_READ_ONLY |
4 |
帮定变量是只读的，查看返回的错误索引 |
| SNMP_ERROR_GENERAL_VB_ERR |
5 |
普通帮定变量错误，查看返回的错误索引 |
| SNMP_ERROR_NO_ACCESS |
6 |
操作失败，拒绝访问 |
| SNMP_ERROR_WRONG_TYPE |
7 |
操作失败，类型错误 |
| SNMP_ERROR_WRONG_LENGTH |
8 |
操作失败，长度错误 |
| SNMP_ERROR_WRONG_ENCODING |
9 |
操作失败，译码错误 |
| SNMP_ERROR_WRONG_VALUE |
10 |
操作失败，值错误 |
| SNMP_ERROR_NO_CREATION |
11 |
操作失败，拒绝创建 |
| SNMP_ERROR_INCONSIST_VAL |
12 |
操作失败，值不相容 |
| SNMP_ERROR_RESOURCE_UNAVAIL |
13 |
操作失败，无法使用资源 |
| SNMP_ERROR_COMITFAIL |
14 |
操作失败，提交失败 |
| SNMP_ERROR_UNDO_FAIL |
15 |
操作失败，撤销失败 |
| SNMP_ERROR_AUTH_ERR |
16 |
操作失败，权限错误 |
| SNMP_ERROR_NOT_WRITEABLE |
17 |
操作失败，拒绝更改 |
| SNMP_ERROR_INCONSIS_NAME |
18 |
操作失败，名字不相容 |