SnmpFreeVbl 函数 (winsnmp.h)

项目
08/27/2023

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

WinSNMP SnmpFreeVbl 函数释放与变量绑定列表关联的资源。这些是以前通过调用 WinSNMP 应用程序中的 SnmpCreateVbl 函数或 SnmpDuplicateVbl 函数分配的资源。

语法

SNMPAPI_STATUS SNMPAPI_CALL SnmpFreeVbl(
  [in] HSNMP_VBL vbl
);

参数

[in] vbl

要发布的变量绑定列表的句柄。

返回值

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

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

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

注解

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

如果应用程序调用 SnmpClose 或 SnmpCleanup 函数，则 Microsoft WinSNMP 实现将释放它为 WinSNMP 会话分配的所有资源。但是，即使应用程序不重复使用变量绑定列表句柄，也建议应用程序使用 SnmpFreeVbl 函数释放单个变量绑定资源。这可减少实现的工作负荷，并应增强其对所有应用程序的服务。有关其他信息，请参阅 WinSNMP 数据管理概念。

要求


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