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 函数可能会返回以下错误之一。
返回代码 | 说明 |
---|---|
|
SnmpStartup 函数未成功完成。 |
|
内存分配期间出错。 |
|
hEntity 参数无效。 |
|
nPolicyRetry 和 nActualRetry 参数均为 NULL。 未执行该操作。 |
|
发生未知或未定义的错误。 |
注解
通常,WinSNMP 应用程序而不是代理应用程序调用 SnmpGetRetry 函数。
WinSNMP 应用程序可以通过调用 SnmpSetRetry 函数来修改重试计数值。
WinSNMP 应用程序可以监视 nActualRetry 参数的值,并将其与 nPolicyRetry 参数的值进行比较,以优化传输性能。 有关详细信息,请参阅 关于重新传输 和管理 重新传输策略。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | winsnmp.h |
Library | Wsnmp32.lib |
DLL | Wsnmp32.dll |