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 函数可能会返回以下错误之一。
返回代码 | 说明 |
---|---|
|
SnmpStartup 函数未成功完成。 |
|
内存分配期间出错。 |
|
vbl 参数无效。 |
|
索引参数无效。 |
|
name 参数无效。 |
|
value 参数指向的 结构的语法成员无效。 |
|
发生未知或未定义的错误。 |
注解
索引参数的有效值范围为 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 |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈