通过

snmpGetRetransmitMode 函数 (winsnmp.h)

  • 项目

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

WinSNMP SnmpGetRetransmitMode 函数将重新传输模式的当前设置返回到 WinSNMP 应用程序。 Microsoft WinSNMP 实现使用重新传输模式来控制对 SnmpSendMsg 函数的调用时的传输超时和重新传输尝试。

语法

SNMPAPI_STATUS SNMPAPI_CALL SnmpGetRetransmitMode(
  [out] smiLPUINT32 nRetransmitMode
);

参数

[out] nRetransmitMode

指向无符号长整型变量的指针，用于接收对实现有效的当前重新传输模式。 此参数的取值可为下列值之一：

值 含义
SNMPAPI_ON
 实现正在执行 WinSNMP 应用程序的重新传输策略。
SNMPAPI_OFF
 实现不执行 WinSNMP 应用程序的重新传输策略。

返回值

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

如果函数失败，则返回值SNMPAPI_FAILURE。 如果 SnmpGetRetransmitMode 失败， 则 nRetransmitMode 参数的值对应用程序没有意义。 若要获取扩展的错误信息，请调用 SnmpGetLastError，并在其会话参数中指定 NULL 值。 SnmpGetLastError 函数可能会返回以下错误之一。

返回代码 说明
SNMPAPI_NOT_INITIALIZED
 SnmpStartup 函数未成功完成。
SNMPAPI_ALLOC_ERROR
 内存分配期间出错。
SNMPAPI_OTHER_ERROR
 发生未知或未定义的错误。

注解

通常，WinSNMP 应用程序而不是代理应用程序调用 SnmpGetRetransmitMode 函数。 有关详细信息，请参阅 关于重新传输 和管理 重新传输策略。

要求

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

另请参阅

SnmpSetRetransmitMode

SnmpStartup

WinSNMP 函数

WinSNMP API 概述