SNMPAPI_CALLBACK回调函数 (winsnmp.h)

项目
08/27/2023

[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

另请参阅

通过

SNMPAPI_CALLBACK回调函数 (winsnmp.h)

语法

参数

返回值

注解

要求

另请参阅

反馈

反馈

其他资源