snmpCreateVbl 函式 (winsnmp.h)

發行項
08/27/2023

[SNMP 可用於需求一節中指定的作業系統。它在後續版本中可能會變更或無法使用。請改用 Windows 遠端系統管理，這是 WS-Man 的 Microsoft 實作。

WinSNMP SnmpCreateVbl函式會為呼叫的 WinSNMP 應用程式建立新的變數系結清單。如果名稱和值參數不是Null，SnmpCreateVbl會使用其值來建立新變數系結清單的第一個變數系結專案。 SnmpCreateVbl函式會傳回新變數系結清單的控制碼，並為其配置任何必要的記憶體。

語法

HSNMP_VBL SNMPAPI_CALL SnmpCreateVbl(
  [in] HSNMP_SESSION session,
  [in] smiLPCOID     name,
  [in] smiLPCVALUE   value
);

參數

[in] session

WinSNMP 會話的控制碼。

[in] name

smiOID結構的指標，其中包含第一個變數系結專案的變數名稱。此參數可以是 Null。如需詳細資訊，請參閱下列一節。

[in] value

smiVALUE結構的指標，其中包含要與第一個變數系結專案中變數相關聯的值。此參數可以是 Null。如需詳細資訊，請參閱下列一節。

傳回值

如果函式成功，則傳回值是新變數系結清單的控制碼。

如果函式失敗，傳回值會SNMPAPI_FAILURE。若要取得擴充的錯誤資訊，請呼叫 SnmpGetLastError。 SnmpGetLastError 函式可以傳回下列其中一個錯誤。

傳回碼	描述
SNMPAPI_NOT_INITIALIZED	SnmpStartup函式未順利完成。
SNMPAPI_ALLOC_ERROR	記憶體配置期間發生錯誤。
SNMPAPI_SESSION_INVALID	會話控制碼無效。
SNMPAPI_OID_INVALID	name參數會參考無效的 smiOID結構。
SNMPAPI_SYNTAX_INVALID	value參數所指向之結構的語法成員無效。
SNMPAPI_OTHER_ERROR	發生未知或未定義的錯誤。

備註

SnmpCreateVbl函式會使用名稱和值參數的值，來建立和初始化新變數系結清單的第一個變數系結專案。如果 name 參數為 Null，Microsoft WinSNMP 實作會忽略 value 參數，並建立空的變數系結清單。

如果 name 參數不是 Null，但 value 參數為 Null，實作會建立並初始化變數系結清單中的第一個變數系結專案。它會使用值SNMP_SYNTAX_Null，初始化value參數所指向之結構的語法成員。

WinSNMP 應用程式必須釋放與每個變數系結清單相關聯的資源。其應該會比對 SnmpCreateVbl 和 SnmpDuplicateVbl 函式的每個呼叫，並對應 SnmpFreeVbl 函式的呼叫。為了避免記憶體流失，WinSNMP 應用程式必須先呼叫 SnmpFreeVbl ，才能在後續對 SnmpCreateVbl 或 SnmpDuplicateVbl的呼叫中重複使用變數系結清單的控制碼。如需詳細資訊，請參閱WinSNMP 資料管理概念。

規格需求


最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	winsnmp.h
程式庫	Wsnmp32.lib
Dll	Wsnmp32.dll