snmpSetRetransmitMode 函数 (winsnmp.h)
[SNMP 可用于“要求”部分中指定的操作系统。 它可能在后续版本中变更或不可用。 请改用 Windows 远程管理,这是 WS-Man 的 Microsoft 实现。]
WinSNMP SnmpSetRetransmitMode 函数使 WinSNMP 应用程序能够设置重新传输模式。 Microsoft WinSNMP 实现使用新的重新传输模式来管理传输超时,并在后续调用 SnmpSendMsg 函数时重新传输尝试。
语法
SNMPAPI_STATUS SNMPAPI_CALL SnmpSetRetransmitMode(
[in] smiUINT32 nRetransmitMode
);
参数
[in] nRetransmitMode
指定新的重新传输模式的值。 此参数须为下列值之一。
值 | 含义 |
---|---|
|
实现执行 WinSNMP 应用程序的重新传输策略。 |
|
实现不执行 WinSNMP 应用程序的重新传输策略。 |
返回值
如果函数成功,则返回值SNMPAPI_SUCCESS。
如果函数失败,则返回值SNMPAPI_FAILURE。 若要获取扩展的错误信息,请调用 SnmpGetLastError,并在其会话参数中指定 NULL 值。 SnmpGetLastError 函数可能会返回以下错误之一。
返回代码 | 说明 |
---|---|
|
SnmpStartup 函数未成功完成。 |
|
内存分配期间出错。 |
|
实现不支持请求的重新传输模式。 |
|
发生未知或未定义的错误。 |
注解
通常,WinSNMP 管理器应用程序而不是代理应用程序调用 SnmpSetRetransmitMode 函数。
如果 WinSNMP 应用程序将重新传输模式设置为SNMPAPI_OFF,则实现不会为新的 SNMP 通信操作启动重新传输尝试。 新设置会影响对 SnmpSendMsg 函数的所有后续调用,直到 WinSNMP 应用程序将重新传输模式设置回SNMPAPI_ON。
对于特定的 SNMP 消息,调用 SnmpCancelMsg 函数等效于调用 SnmpSetRetransmitMode 函数,其重新传输模式等于SNMPAPI_OFF。
注意 如果实现返回错误SNMPAPI_MODE_INVALID对 SnmpSetRetransmitMode 的调用,则 WinSNMP 应用程序必须执行重新传输策略。
要求
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | winsnmp.h |
Library | Wsnmp32.lib |
DLL | Wsnmp32.dll |