snmpExtensionMonitor 函数 (snmp.h)

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

Microsoft SNMP 服务调用 SnmpExtensionMonitor 函数，为 SNMP 扩展代理提供服务内部计数器和参数的视图。此函数是 SNMP 扩展代理 API 的元素。

SnmpExtensionMonitor 函数是可选的。如果扩展代理对 SNMP 服务的内部管理对象的视图感兴趣，如 RFC 1213“基于 TCP/IP 的 Internet 的网络管理管理信息库：MIB-II”中定义，则扩展代理应实现函数。

语法

BOOL SNMP_FUNC_TYPE SnmpExtensionMonitor(
  [in] LPVOID pAgentMgmtData
);

[in] pAgentMgmtData

指向 asnAny 对象的数组的指针， () 结构。对象的数量以及每个对象的类型和说明符合 RFC 1213。有关更多信息，请参见下面的“备注”部分。

除非 SNMP 扩展代理正在处理 pAgentMgmtData 参数的值时发生意外错误，否则扩展代理应返回 TRUE。如果扩展代理返回 FALSE，则 SNMP 服务不会加载扩展代理，并且该服务将停止将 SNMP 请求定向到扩展代理。

如果扩展代理导出 SnmpExtensionMonitor 函数，SNMP 服务在扩展代理初始化期间立即调用函数，紧接在服务调用 SnmpExtensionInit 和 SnmpExtensionInitEx 函数之后。

SNMP 服务动态更新 snMP 计数器 (例如，snmpInPkts 和 snmpOutNoSuchNames 计数器) pAgentMgmtData 参数指向的数组中。为了能够在 SNMP 服务运行时读取这些值，扩展代理必须存储指向 pAgentMgmtData 的指针。

请注意，SNMP 扩展代理不应更新 pAgentMgmtData 参数指向的内存。这是因为 SNMP 服务的内部计数器的值将不再有效，并且 SNMP 服务的行为可能会变得不可预知。只要扩展代理不更改它， pAgentMgmtData 指向的内存在 SNMP 服务运行时就有效。

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	snmp.h