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和 PDU 資料類型SNMP_PDU_GETBULK。
SnmpDeleteVb函式刪除變數系結專案之後，已刪除專案之後的所有專案的索引值將會遞減一個。 對 SnmpCountVbl 函式的呼叫會傳回變數系結清單中新的專案總數。 新的總計小於目前呼叫SnmpDeleteVb之前，呼叫SnmpCountVbl所傳回的計數。
如果 WinSNMP 應用程式呼叫 SnmpDeleteVb 函式，並刪除變數系結清單中的最後一個變數系結專案，結果就是空的變數系結清單。 變數系結清單仍然具有有效的控制碼，而且 WinSNMP 應用程式必須釋放控制碼，並呼叫 SnmpFreeVbl 函式。
以下是用於 索引 參數的有效值：
- 從對 SnmpCountVbl函式的呼叫傳回值
- 呼叫SnmpRecvMsg函式所傳回之SNMP_PDU_RESPONSE PDU 的錯誤索引欄位
規格需求
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | winsnmp.h |
| 程式庫 | Wsnmp32.lib |
| Dll | Wsnmp32.dll |