snmpSetVb 函数 (winsnmp.h)

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

WinSNMP SnmpSetVb 函数更改变量绑定列表中的变量绑定条目。此函数还会将新的变量绑定条目追加到现有变量绑定列表。

语法

SNMPAPI_STATUS SNMPAPI_CALL SnmpSetVb(
  [in] HSNMP_VBL   vbl,
  [in] smiUINT32   index,
  [in] smiLPCOID   name,
  [in] smiLPCVALUE value
);

[in] vbl

要更新的变量绑定列表的句柄。

[in] index

指定一个无符号长整型变量，该变量包含变量绑定项在变量绑定列表中的位置（如果这是更新操作）。如果这是追加操作，则此参数必须等于零。有关更多信息，请参见下面的“备注”部分。

[in] name

指向 smiOID 结构的指针，该结构表示要追加或更改的变量的名称。有关更多信息，请参见下面的“备注”部分。

[in] value

指向 smiVALUE 结构的指针。结构包含与 name 参数指定的变量关联的值。

如果函数成功，则返回值是更新或追加的变量绑定项在变量绑定列表中的位置。有关其他信息，请参阅以下“备注”部分。

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

索引参数的有效值范围为 0 到 n。值零指示追加操作。值 n 是变量绑定列表中变量绑定条目的总数。 WinSNMP 应用程序应在调用 SnmpSetVb 以获取变量绑定条目的总数之前调用 SnmpCountVbl 函数。

如果函数成功执行更新操作，则返回值等于索引参数的值。如果函数追加变量绑定项，则返回值为 n + 1。

如果 name 参数不为 NULL，但 value 参数为 NULL，则 Microsoft WinSNMP 实现初始化新的变量绑定条目，并将 value 成员设置为 NULL，语法成员设置为 SNMP_SYNTAX_。

如果 index 参数不等于零，并且 name 参数为 NULL，则 Microsoft WinSNMP 实现仅更新索引参数指向的变量的值。


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