SnmpDeleteVb 函数 (winsnmp.h)
[SNMP 可用于“要求”部分中指定的操作系统。 它可能在后续版本中变更或不可用。 请改用 Windows 远程管理,这是 WS-Man 的 Microsoft 实现。]
WinSNMP SnmpDeleteVb 函数从变量绑定列表中删除变量绑定条目。
语法
SNMPAPI_STATUS SNMPAPI_CALL SnmpDeleteVb(
[in] HSNMP_VBL vbl,
[in] smiUINT32 index
);
参数
[in] vbl
要更新的变量绑定列表的句柄。
[in] index
指定要删除的变量绑定项的无符号长整数变量。 此变量包含变量绑定项在变量绑定列表中的位置。
此参数的有效值在 1 到 n 的范围内,其中 1 表示变量绑定列表中的第一个变量绑定条目,n 是变量绑定列表中的条目总数。 有关其他信息,请参阅以下“备注”部分。
返回值
如果函数成功,则返回值SNMPAPI_SUCCESS。
如果函数失败,则返回值SNMPAPI_FAILURE。 若要获取扩展错误信息,请调用 SnmpGetLastError。 SnmpGetLastError 函数可能会返回以下错误之一。
返回代码 | 说明 |
---|---|
|
SnmpStartup 函数未成功完成。 |
|
内存分配期间出错。 |
|
索引参数无效。 |
|
vbl 参数无效。 |
|
发生未知或未定义错误。 |
注解
WinSNMP 应用程序可以使用 SnmpDeleteVb 函数删除无效的变量绑定条目。 当 SNMP_PDU_RESPONSE 协议数据单元 (PDU) 包含指示变量绑定条目无效的错误时,应用程序可以调用 SnmpDeleteVb 来删除该条目。 然后,应用程序可以通过调用 SnmpSendMsg 函数重新提交请求 PDU,而无需变量绑定列表中的无效变量绑定条目。 请求 PDU 包括SNMP_PDU_GET、SNMP_PDU_GETNEXT和SNMP_PDU_GETBULK PDU 数据类型。
SnmpDeleteVb 函数删除变量绑定项后,删除项后的所有条目的索引值将递减 1。 调用 SnmpCountVbl 函数将返回变量绑定列表中新的条目总数。 新总数比在当前调用 SnmpDeleteVb 之前调用 SnmpCountVbl 返回的计数少 1。
如果 WinSNMP 应用程序调用 SnmpDeleteVb 函数并删除变量绑定列表中的最后一个变量绑定项,则结果为空变量绑定列表。 变量绑定列表仍具有有效的句柄,WinSNMP 应用程序必须通过调用 SnmpFreeVbl 函数释放句柄。
下面是要用于 索引 参数的有效值:
- 调用 SnmpCountVbl 函数的返回值
- 调用 SnmpRecvMsg 函数返回的SNMP_PDU_RESPONSE PDU 的错误索引字段
要求
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | winsnmp.h |
Library | Wsnmp32.lib |
DLL | Wsnmp32.dll |