SnmpCancelMsg 函数 (winsnmp.h)

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

WinSNMP 应用程序调用 SnmpCancelMsg 函数，以请求 Microsoft WinSNMP 实现取消 SNMP 请求消息的重新传输尝试和超时通知。 SnmpCancelMsg 函数是 WinSNMP API 版本 2.0 的元素。

语法

SNMPAPI_STATUS SNMPAPI_CALL SnmpCancelMsg(
  [in] HSNMP_SESSION session,
  [in] smiINT32      reqId
);

[in] session

提交 SNMP 请求消息的 WinSNMP 会话的句柄 (要取消的 PDU) 。

[in] reqId

指定标识相关 PDU 的唯一数值。此参数必须与应用程序对 SnmpSendMsg 函数的初始调用中指定的 PDU 参数的请求标识符 (request_id) 匹配。

如果函数成功，则返回值SNMPAPI_SUCCESS。

如果函数失败，则返回值SNMPAPI_FAILURE。若要获取扩展的错误信息，请调用 SnmpGetLastError。 SnmpGetLastError 函数可能会返回以下错误之一。

对于特定的 SNMP 消息，调用 SnmpCancelMsg 函数等效于调用 SnmpSetRetransmitMode 函数，其重新传输模式等于SNMPAPI_OFF。

有关详细信息，请参阅取消重新传输和管理重新传输策略。

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