SNMP编译错误消息-Read.doc

WinSNMP API规范 北京佳合通信技术公司 王朋武 Sep. 27,2002 E-mail: pengwuwang@21 或 darlingpeng@ WinSNMP编程任务 下表总结编码WinSNMP管理器应用程序必须执行的基本编程步骤，并提供有关引起任务信息的主题。 编程任务 与任务有关函数和主题 打开WinSNMP应用程序 用SnmpStartup 参见打开和关闭WinSNMP管理器应用程序 打开一个或多个WinSNMP会话 用SnmpOpen 参见打开和关闭WinSNMP会话 注册接收自陷或通知 用SnmpRegister 参见管理自陷和通知 产生一个或多个变量绑定列表结合到一个PDU中 用SnmpCreateVbl,SnmpDuplicateVbl,SnmpSetVb 参见用变量绑定列表工作 注意：应用程序或许还需要调用其它变量绑定函数来产生变量绑定列表 提交一个或多个SNMP操作请求 用SnmpSendMsg 参见发送SNMP消息 检取SNMP操作请求的应答 用SnmpRecvMsg 参见接收SNMP消息 处理请求应答 使用应用程序特定逻辑 关闭每一个WinSNMP会话 用SnmpClose 参见打开和关闭WinSNMP会话 关闭WinSNMP应用程序 用SnmpCleanup 参见打开和关闭WinSNMP管理器应用程序 下面主题包含有关WinSNMP环境特定的其它的一些一般编程概念。 一般编程任务 管理对象标识符 释放WinSNMP描述符 设定实体和上下文转换模式 管理重发政策 另外，WinSNMP管理器应用程序也许需要混合调用下列WinSNMP函数：SnmpFreeVbl, SnmpFreeEntity, SnmpFreeDescriptor, SnmpFreeContext,和SnmpFreePdu。 管理对象标识符 释放WinSNMP描述符 设定实体和上下文转换模式 管理重发政策 SNMP支持的级别 微软WinSNMP实现提供SNMP通信支持的多个级别。这些级别列于下表。 级别 意义 0级 只支持消息编码与解码。0级别支持不提供通信传输服务。不支持SnmpSendMsg,SnmpRecvMsg,SnmpRegister函数。因为这些函数需要与其它SNMP实体通信。 1级 支持0级通信和SNMP版本1框架(SNMPv1)下的与SNMP代理实体相互操作。 2级 支持1级通信和SNMP版本2框架(SNMPv2C)下的与SNMP代理实体相互操作。 实现返回支持的SNMP通信的最大级别作为WinSNMP管理器应用程序调用SnmpStartup函数的响应。 如果WinSNMP管理器应用程序使用此实现只是SNMP消息编码和解码，则应用程序必须进行由实现执行的需要的转换。这包括转换SnmpRecvMsg函数返回的SNMPv1自陷到SNMPv2C自陷。也包括用SNMPv1定义的PDU类型到与RFC1908一致的SNMPv2C定义的相关类型。 关于SNMP版本 RFC1155,RFC1157,RFC1213中描述的原始的Internet标准网络管理框架被称为SNMP第一版（SNMPv1）框架。对简单网络管理协议2C版（SNMPv2C）的被提议框架的相关部分由RFC1901到RFC1908描述。 WinSNMP管理器API支持在相关Internet RFC中描述的SNMP协议功能。WinSNMP对WinSNMP管理器应用程序使用SNMPv1或SNMPv2C没有约束。 管理实体能够支持与WinSNMP管理器应用程序支持的版本不同版本的SNMP。微软WinSNMP实现依照相关RFC执行从SNMPv1到SNMPv2C的适当的转换。 自陷从SNMPv1转换到SNMPv2C 当微软WinSNMP实现从SNMPv1框架下的实体的操作中收到自陷时，它把此自陷转换到SNMPv2C格式。因此，当SnmpRecvMsg传送自陷时它总是用SNMPv2C格式。RFC1908即”Internet标准网络管理框架的版本1和版本2的共存”详细说明从SNMPv1到SNMPv2C转换自陷格式的规则。 WinSNMP管理器应用程序可以检查变量绑定列表中的最后一个变量绑定入口来决定入口是否是从SNMPv1转换到SNMPv2C格式的自陷。如果是这样，最后一个变量绑定将永远等于值”snmpTrapEnterpriseOID.0”。 关于SNMP消息 简单网络管理协议使用消息来通信，并在远地SNMP实体间交换信息。SNMP消息包含协议数据单元（PDU）及相关RFC定义的附加消息头元素。PDU是包含SNMP数据成份（或域）的数据包。 SNMP消息的格式对SNMPv1和SNMPv2都相同。但是，SNMPv2