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 函式可以傳回下列其中一個錯誤。

索引參數的有效值範圍從零到 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