SNMPAPI_CALLBACK回调函数 (winsnmp.h)
[SNMP 可用于“要求”部分中指定的操作系统。 它可能在后续版本中变更或不可用。 请改用 Windows 远程管理,这是 WS-Man 的 Microsoft 实现。]
Microsoft WinSNMP 实现调用 SNMPAPI_CALLBACK 函数以通知 WinSNMP 会话 SNMP 消息或异步事件可用。
SNMPAPI_CALLBACK 是应用程序或库定义的回调函数名称的占位符。
语法
SNMPAPI_CALLBACK SnmpapiCallback;
SNMPAPI_STATUS SnmpapiCallback(
[in] HSNMP_SESSION hSession,
[in] HWND hWnd,
[in] UINT wMsg,
[in] WPARAM wParam,
[in] LPARAM lParam,
[in] LPVOID lpClientData
)
{...}
参数
[in] hSession
WinSNMP 会话的句柄。
[in] hWnd
WinSNMP 应用程序窗口的句柄,用于在异步请求完成或发生陷阱通知时发出通知。 此参数对 WinSNMP 会话没有意义,但实现始终将值传递给回调函数。
[in] wMsg
指定一个无符号整数,用于标识要发送到 WinSNMP 应用程序窗口的通知消息。 此参数对 WinSNMP 会话没有意义,但实现始终将值传递给回调函数。
[in] wParam
指定应用程序定义的 32 位值,该值标识通知的类型。 如果此参数等于零,则 SNMP 消息可用于会话。 应用程序应调用 SnmpRecvMsg 函数来检索消息。 如果此参数不等于零,则表示会话的异步事件通知。 有关其他信息,请参阅以下“备注”部分。
[in] lParam
指定应用程序定义的 32 位值,该值指定正在处理的 PDU 的请求标识符。
[in] lpClientData
如果在调用此会话的 SnmpCreateSession 函数时 lpClientData 参数不为 NULL,则此参数是指向应用程序定义数据的指针。
返回值
函数必须返回SNMPAPI_SUCCESS才能继续执行应用程序。 如果函数返回任何其他值,则实现将响应,就像应用程序为指示的会话调用 SnmpClose 函数一样。
注解
当实现执行 WinSNMP 应用程序的重新传输策略并发生传输超时时,实现会将错误通知会话。 在这种情况下, wParam 参数的值将SNMPAPI_TL_TIMEOUT。 有关其他传输层错误的列表,请参阅 SnmpRegister、 SnmpSendMsg 和 SnmpRecvMsg 函数的参考页。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | winsnmp.h |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈