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參數所指向之 結構的語法成員無效。 |
|
發生未知或未定義的錯誤。 |
備註
索引參數的有效值範圍從零到 n。 值零表示附加作業。 值 n 是變數系結清單中的變數系結專案總數。 WinSNMP 應用程式應該先呼叫 SnmpCountVbl 函式，再呼叫 SnmpSetVb 以取得變數繫結項目的總數。
如果函式成功執行更新作業，傳回值等於 索引 參數的值。 如果函式附加變數系結專案，則傳回值為 n + 1。
如果 name 參數不是 Null，但 value 參數為 Null，則 Microsoft WinSNMP 實作會初始化新的變數系結專案，並將 值 成員設定為 Null ，並將 語法 成員設定為 SNMP_SYNTAX_。
如果 index 參數不等於零， 且 name 參數為 Null，則 Microsoft WinSNMP 實作只會更新 索引 參數所指向之變數的值。
規格需求
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | winsnmp.h |
| 程式庫 | Wsnmp32.lib |
| Dll | Wsnmp32.dll |