SnmpCreateVbl 函数 (winsnmp.h)

  • 项目

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

WinSNMP SnmpCreateVbl 函数为调用 WinSNMP 应用程序创建新的变量绑定列表。 如果名称和值参数不为 NULL，SnmpCreateVbl 使用其值为新变量绑定列表创建第一个变量绑定条目。 SnmpCreateVbl 函数返回新变量绑定列表的句柄，并为其分配任何必要的内存。

语法

HSNMP_VBL SNMPAPI_CALL SnmpCreateVbl(
  [in] HSNMP_SESSION session,
  [in] smiLPCOID     name,
  [in] smiLPCVALUE   value
);

参数

[in] session

WinSNMP 会话的句柄。

[in] name

指向 smiOID 结构的指针，该结构包含第一个变量绑定条目的变量名称。 此参数可以为 NULL。 有关其他信息，请参阅以下“备注”部分。

[in] value

指向 smiVALUE 结构的指针，该结构包含要与第一个变量绑定条目中的变量关联的值。 此参数可以为 NULL。 有关其他信息，请参阅以下“备注”部分。

返回值

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

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

返回代码 说明
SNMPAPI_NOT_INITIALIZED
 SnmpStartup 函数未成功完成。
SNMPAPI_ALLOC_ERROR
 内存分配期间出错。
SNMPAPI_SESSION_INVALID
 会话句柄无效。
SNMPAPI_OID_INVALID
 name 参数引用无效的 smiOID 结构。
SNMPAPI_SYNTAX_INVALID
 值参数指向的结构的语法成员无效。
SNMPAPI_OTHER_ERROR
 发生未知或未定义错误。

注解

SnmpCreateVbl 函数使用名称和值参数的值来创建和初始化新变量绑定列表的第一个变量绑定条目。 如果 name 参数为 NULL，则 Microsoft WinSNMP 实现将忽略 值 参数并创建空变量绑定列表。

如果 name 参数不为 NULL，但 值 参数为 NULL，则实现将创建并初始化变量绑定列表中的第一个变量绑定条目。 它使用值SNMP_SYNTAX_NULL初始化 value 参数指向的结构的语法成员。

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

要求

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

另请参阅

SnmpDuplicateVbl

SnmpFreeVbl

WinSNMP 函数

WinSNMP API 概述

smiOID

smiVALUE