snmpGetRetry 函数 (winsnmp.h)

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

WinSNMP SnmpGetRetry 函数返回重新传输 SNMP 消息请求的重试计数值（以单位为单位）。重试计数适用于 WinSNMP 应用程序对指定管理实体的 SnmpSendMsg 函数的调用。

语法

SNMPAPI_STATUS SNMPAPI_CALL SnmpGetRetry(
  [in]  HSNMP_ENTITY hEntity,
  [out] smiLPUINT32  nPolicyRetry,
  [out] smiLPUINT32  nActualRetry
);

[in] hEntity

目标管理实体的句柄。

[out] nPolicyRetry

指向无符号长整型变量的指针，用于接收指定管理实体的重试计数值。这是 Microsoft WinSNMP 实现存储在数据库中的值。如果不需要此参数中返回的信息， 则 nPolicyRetry 必须是 NULL 指针。

[out] nActualRetry

指向无符号长整型变量的指针，用于接收目标实体的最后一个实际或估计重试计数，由实现报告。如果不需要此参数中返回的信息， 则 nActualRetry 必须是 NULL 指针。如果此参数是有效的指针，则函数返回 0。有关其他信息，请参阅以下“备注”部分。

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

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

返回代码	说明
SNMPAPI_NOT_INITIALIZED	SnmpStartup 函数未成功完成。
SNMPAPI_ALLOC_ERROR	内存分配期间出错。
SNMPAPI_ENTITY_INVALID	hEntity 参数无效。
SNMPAPI_NOOP	nPolicyRetry 和 nActualRetry 参数均为 NULL。未执行该操作。
SNMPAPI_OTHER_ERROR	发生未知或未定义的错误。

通常，WinSNMP 应用程序而不是代理应用程序调用 SnmpGetRetry 函数。

WinSNMP 应用程序可以通过调用 SnmpSetRetry 函数来修改重试计数值。

WinSNMP 应用程序可以监视 nActualRetry 参数的值，并将其与 nPolicyRetry 参数的值进行比较，以优化传输性能。有关详细信息，请参阅关于重新传输和管理重新传输策略。

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