WinSNMP 函数

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

与 WinSNMP 一起使用的函数属于以下函数分组。 接下来是字母列表。

WinSNMP 通信函数

WinSNMP 通信函数在调用 WinSNMP 应用程序和 Microsoft WinSNMP 实现之间提供接口。 实现处理应用程序与其他管理实体之间的通信。

功能 说明
SnmpCancelMsg 请求 Microsoft WinSNMP 实现取消 SNMP 请求消息的重新传输尝试和超时通知。
SnmpCleanup 通知实现应用程序正在断开连接,并且不再需要分配的资源。
SnmpCleanupEx 在 WinSNMP 应用程序中没有未完成的成功调用 SnmpStartupSnmpStartupEx 时执行清理。
SnmpClose 使 实现能够解除分配与会话关联的资源,并关闭通信机制。
SnmpCreateSession 请求实现打开 WinSNMP 会话并分配资源和通信机制。 开发新的 WinSNMP 应用程序时,建议调用 SnmpCreateSession 函数以打开 WinSNMP 会话,而不是调用 SnmpOpen 函数。
SnmpListen 将 WinSNMP 应用程序注册或注销为 SNMP 代理。
SnmpOpen 请求实现打开 WinSNMP 会话并分配资源和通信机制。 开发新的 WinSNMP 应用程序时,建议调用 SnmpCreateSession 函数以打开 WinSNMP 会话,而不是调用 SnmpOpen 函数。
SnmpRecvMsg 返回 SNMP 消息以及未完成的陷阱数据和通知。
SnmpRegister 通知实现应用程序需要注册或取消注册陷阱和通知。
SnmpSendMsg 请求实现传输协议数据单元。
SnmpStartup 通知实现为应用程序执行初始化过程。 应用程序必须在调用任何其他 WinSNMP 函数之前成功调用 SnmpStartup 函数。
SnmpStartupEx 通知 Microsoft WinSNMP 实现 WinSNMP 应用程序需要实现的服务。 SnmpStartupEx 支持在同一应用程序中使用 WinSNMP 的多个独立软件模块。
SNMPAPI_CALLBACK 通知 WinSNMP 会话 SNMP 消息或异步事件可用。 注意: 此回调函数仅适用于由于调用 SnmpCreateSession 函数而打开的会话。

WinSNMP 实体和上下文函数

WinSNMP 实体和上下文函数使 WinSNMP 应用程序能够指定 SNMP 实体和上下文的用户友好名称。 Microsoft WinSNMP 实现使用实现的数据库将名称转换为其 SNMPv1 或 SNMPv2C 组件。

功能 说明
SnmpContextToStr 返回一个字符串,该字符串标识 (一组托管对象资源) SNMP 上下文。
SnmpEntityToStr 返回标识 SNMP 管理实体的字符串。
SnmpFreeContext 释放 SnmpStrToContext 函数为 SNMP 上下文分配的资源。
SnmpFreeEntity 释放 SnmpStrToEntity 函数为 SNMP 管理实体分配的资源。
SnmpSetPort 更改分配给 SNMP 目标实体的端口。
SnmpStrToContext 返回特定于实现的 SNMP 上下文信息的句柄。
SnmpStrToEntity 返回特定于实现的 SNMP 管理实体信息的句柄。

WinSNMP 数据库函数

WinSNMP 数据库函数为 WinSNMP 应用程序提供对 Microsoft WinSNMP 实现的管理信息存储中的当前设置的访问权限。 这些函数允许更改重新传输模式以及实体和上下文转换模式。 数据库函数还为应用程序提供操作超时和重试计数值的能力。

功能 说明
SnmpGetRetransmitMode 返回重新传输模式的当前设置。
SnmpGetRetry 返回重新传输 SNMP 消息请求的重试计数值(单位)。
SnmpGetTimeout 返回 SNMP 消息请求传输的超时值(以百分之一秒为单位)。
SnmpGetTranslateMode 返回实体和上下文转换模式的当前设置。
SnmpGetVendorInfo 检索标识 WinSNMP 供应商的信息。
SnmpSetRetransmitMode 更改重新传输模式。
SnmpSetRetry 更改重新传输 SNMP 消息请求的重试计数值。
SnmpSetTimeout 更改 SNMP 消息请求传输的超时值。
SnmpSetTranslateMode 更改实体和上下文转换模式。

WinSNMP PDU 函数

WinSNMP PDU 函数使 WinSNMP 应用程序能够提取和更新 PDU (或字段) 的数据元素。 这包括通过调用 SnmpRecvMsg 函数或 SnmpDecodeMsg 函数返回的 PDU。 PDU 函数还构造 PDU,以便在 SnmpSendMsgSnmpEncodeMsg 函数中使用。

功能 说明
SnmpCreatePdu 创建并初始化 SNMP 协议数据单元。
SnmpDuplicatePdu 复制 SNMP 协议数据单元。
SnmpFreePdu 释放与 SnmpCreatePduSnmpDuplicatePdu 函数创建的 SNMP 协议数据单元关联的资源。
SnmpGetPduData 从指定的 SNMP 协议数据单元返回选定的数据元素。
SnmpSetPduData 在指定的 SNMP 协议数据单元中汇报选定的数据元素。

WinSNMP 实用工具函数

WinSNMP 实用工具函数使 WinSNMP 应用程序能够跨 WinSNMP 接口管理对象和 SNMP 消息。

功能 说明
SnmpDecodeMsg 将编码或序列化的 SNMP 消息解码为其组成组件。
SnmpEncodeMsg 创建编码的 SNMP 消息。
SnmpFreeDescriptor 指示 Microsoft WinSNMP 实现应释放为特定描述符分配的内存。
SnmpGetLastError 返回上次 SNMP 操作的最后一个错误代码值。
SnmpOidCompare 比较两个 SNMP 对象标识符。
SnmpOidCopy 复制 SNMP 对象标识符。
SnmpOidToStr 将 SNMP 对象标识符的内部二进制表示形式转换为其虚数字字符串格式。
SnmpStrToOid 将 SNMP 对象标识符的点数值字符串格式转换为其内部二进制表示形式。

WinSNMP 变量绑定函数

WinSNMP 变量绑定函数使 WinSNMP 应用程序能够构造和操作变量绑定列表,并将其包含在 PDU 中。

功能 说明
SnmpCountVbl 枚举指定变量绑定列表中的变量绑定条目。
SnmpCreateVbl 创建新的变量绑定列表。
SnmpDeleteVb 从变量绑定列表中删除变量绑定条目。
SnmpDuplicateVbl 复制变量绑定列表。
SnmpFreeVbl 释放以前由 SnmpCreateVblSnmpDuplicateVbl 函数分配的变量绑定列表的资源。
SnmpGetVb 从指定的变量绑定条目检索信息。
SnmpSetVb 更改变量绑定列表中的变量绑定条目;将新的变量绑定条目追加到现有变量绑定列表。

WinSNMP 函数字母列表