SnmpDuplicateVbl 函数 (winsnmp.h)

  • 项目

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

WinSNMP SnmpDuplicateVbl 函数为指定的 WinSNMP 会话复制变量绑定列表。 此函数返回复制的变量绑定列表的句柄，并为其分配任何必要的内存。

语法

HSNMP_VBL SNMPAPI_CALL SnmpDuplicateVbl(
  [in] HSNMP_SESSION session,
  [in] HSNMP_VBL     vbl
);

参数

[in] session

WinSNMP 会话的句柄。

[in] vbl

要复制的变量绑定列表的句柄。 源变量绑定列表可以为空。

返回值

如果函数成功，则返回值是新变量绑定列表的句柄。

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

返回代码 说明
SNMPAPI_NOT_INITIALIZED
 SnmpStartup 函数未成功完成。
SNMPAPI_ALLOC_ERROR
 内存分配期间出错。
SNMPAPI_SESSION_INVALID
 会话句柄无效。
SNMPAPI_VBL_INVALID
 vbl 参数无效。
SNMPAPI_OTHER_ERROR
 发生未知或未定义错误。

注解

SnmpDuplicateVbl 函数为指定的 WinSNMP 会话创建新的变量绑定列表。 此函数使用源变量绑定列表中数据的副本初始化新列表。

SnmpDuplicateVbl 函数返回的句柄在 WinSNMP 应用程序中处于活动状态的变量绑定列表句柄中是唯一的。

WinSNMP 应用程序必须释放与每个变量绑定列表关联的资源。 它应通过将对 SnmpCreateVbl 和 SnmpDuplicateVbl 函数的每个调用与 SnmpFreeVbl 函数的相应调用相匹配来执行此操作。 为了避免内存泄漏，WinSNMP 应用程序必须先调用 SnmpFreeVbl ，然后才能在后续调用 SnmpCreateVbl 或 SnmpDuplicateVbl 时重用变量绑定列表的句柄。 有关其他信息，请参阅 WinSNMP 数据管理概念。

要求

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

另请参阅

SnmpCreateVbl

SnmpFreeVbl

WinSNMP 函数

WinSNMP API 概述