SNMP 函数

[SNMP 可用于“要求”部分中指定的操作系统。 它可能在后续版本中变更或不可用。 请改用 Windows 远程管理，这是 WS-Man 的 Microsoft 实现。]

本主题介绍 SNMP 函数的三组，并列出了每个组中包含的函数：

• SNMP 扩展代理 API 函数
• SNMP 管理 API 函数
• SNMP 实用工具 API 函数

SNMP 扩展代理 API 函数

SNMP 扩展代理函数定义 SNMP 服务与第三方 SNMP 扩展代理 DLL 之间的接口。 下表列出了应用程序可用于解析传入 SNMP 协议数据单元 (PDU) 指定的变量绑定的函数。

SNMP 扩展代理 API 函数	说明
SnmpExtensionClose	请求 SNMP 扩展代理解除分配资源和终止操作。
SnmpExtensionInit	初始化 SNMP 扩展代理 DLL。
SnmpExtensionInitEx	标识 SNMP 扩展代理支持的 MIB) 子树 (任何其他管理信息库。
SnmpExtensionMonitor	为 SNMP 扩展代理提供有关服务的内部计数器和参数的信息。
SnmpExtensionQuery	解析 SNMP 请求，这些请求包含 SNMP 扩展代理的一个或多个已注册 MIB 子树中的变量。
SnmpExtensionQueryEx	处理 SNMP 请求，这些请求在 SNMP 扩展代理注册的一个或多个 MIB 子树中指定变量。
SnmpExtensionTrap	检索服务为 SNMP 扩展代理生成陷阱所需的信息。

 

SNMP 管理 API 函数

SNMP 管理功能定义第三方 SNMP 管理器应用程序与管理功能动态链接库 (DLL) Mgmtapi.dll之间的接口。 DLL 与 SNMP 陷阱服务 (Snmptrap.exe) 结合使用，可以与一个或多个第三方 SNMP 管理器应用程序交互。 下表列出了第三方管理器应用程序用于执行 SNMP 管理器操作的管理功能。

SNMP 管理 API 函数	说明
SnmpMgrClose	关闭与指定会话关联的通信套接字和数据结构。
SnmpMgrCtl	设置与 SNMP 会话关联的操作参数。
SnmpMgrGetTrap	如果启用了陷阱接收，则返回调用方未接收的未完成的陷阱数据。
SnmpMgrGetTrapEx	如果启用了陷阱接收，则返回调用方未接收的未完成的陷阱数据。 还返回传输源的地址以及与陷阱关联的社区陷阱。
SnmpMgrOidToStr	将内部对象标识符结构转换为其字符串表示形式。
SnmpMgrOpen	初始化与 SNMP 代理建立通信所需的通信套接字和数据结构。
SnmpMgrRequest	请求指定的代理执行指定的操作。
SnmpMgrStrToOid	将对象标识符的字符串格式转换为其内部对象标识符结构。
SnmpMgrTrapListen	注册 SNMP 管理器应用程序从 SNMP 陷阱服务接收 SNMP 陷阱的能力。

 

SNMP 实用工具 API 函数

SNMP 实用工具函数提供在 SNMP 应用程序开发期间有用的功能，包括简化 SNMP 数据结构的操作。 下表列出了 SNMP 实用工具函数。

SNMP 实用工具 API 函数	说明
SnmpSvcGetUptime	检索 SNMP 服务一直在运行的时间（以 centiseconds 为单位）。
SnmpSvcSetLogLevel	调整 SNMP 服务和 SNMP 扩展代理的调试输出的详细信息级别。
SnmpSvcSetLogType	调整 SNMP 服务和 SNMP 扩展代理的调试输出的目标。
SnmpUtilAsnAnyCpy	将源 AsnAny 结构复制到目标 AsnAny 结构。
SnmpUtilAsnAnyFree	释放为指定的 AsnAny 结构分配的内存。
SnmpUtilDbgPrint	设置要从 SNMP 服务或从 SnmpUtilDbgPrint 调用接收的调试信息的级别。
SnmpUtilIdsToA	将对象标识符 (OID) 转换为以 null 结尾的字符串。
SnmpUtilMemAlloc	从进程堆分配动态内存。
SnmpUtilMemFree	释放指定的内存对象。
SnmpUtilMemReAlloc	更改指定内存对象的大小。
SnmpUtilOctetsCmp	比较两个八进制字符串。
SnmpUtilOctetsCpy	将源 AsnOctetString 结构复制到目标 AsnOctetString 结构。
SnmpUtilOctetsFree	释放为指定八进制字符串分配的内存。
SnmpUtilOctetsNCmp	执行两个八进制字符串与指定数量的子字符串的比较。
SnmpUtilOidAppend	将 AsnObjectIdentifier 结构中包含的源对象标识符追加到目标对象标识符。
SnmpUtilOidCmp	比较 AsnObjectIdentifier 结构中包含的两个对象标识符。
SnmpUtilOidCpy	将源 AsnObjectIdentifier 结构复制到目标 AsnObjectIdentifier 结构。
SnmpUtilOidFree	释放为指定的对象标识符分配的内存。
SnmpUtilOidNCmp	将 AsnObjectIdentifier 结构中包含的两个对象标识符与指定数量的子标识符进行比较。
SnmpUtilOidToA	将对象标识符 (OID) 转换为以 null 结尾的字符串。
SnmpUtilPrintAsnAny	打印 AsnAny 结构中包含的值，以便进行调试和开发。
SnmpUtilPrintOid	(OID) 设置指定对象标识符的格式，并将结果输出到标准输出设备。
SnmpUtilVarBindCpy	将源 SnmpVarBind 结构复制到目标 SnmpVarBind 结构。
SnmpUtilVarBindListCpy	将源 SnmpVarBindList 结构复制到目标 SnmpVarBindList 结构。
SnmpUtilVarBindFree	释放为指定的 SnmpVarBind 结构分配的内存。
SnmpUtilVarBindListFree	释放为指定的 SnmpVarBindList 结构分配的内存。