共用方式為

WinSNMP 函式

  • 發行項

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

與 WinSNMP 搭配使用的函式屬於下列功能群組。 後面接著字母清單。

WinSNMP 通訊函式

WinSNMP 通訊函式提供呼叫 WinSNMP 應用程式與 Microsoft WinSNMP 實作之間的介面。 實作會處理應用程式與其他管理實體之間的通訊。

函式 描述
SnmpCancelMsg 要求 Microsoft WinSNMP 實作取消重新傳輸嘗試和 SNMP 要求訊息的逾時通知。
SnmpCleanup 通知實作應用程式中斷連線，且不再需要已配置的資源。
SnmpCleanupEx 在 WinSNMP 應用程式內沒有未完成對 SnmpStartup 或 SnmpStartupEx 的呼叫時，執行清除。
SnmpClose 讓實作能夠解除配置與會話相關聯的資源，並關閉通訊機制。
SnmpCreateSession 要求實作開啟 WinSNMP 會話，並配置資源和通訊機制。 開發新的 WinSNMP 應用程式時，建議您呼叫 SnmpCreateSession 函式來開啟 WinSNMP 會話，而不是呼叫 SnmpOpen 函式。
SnmpListen 將 WinSNMP 應用程式註冊或取消註冊為 SNMP 代理程式。
SnmpOpen 要求實作開啟 WinSNMP 會話，並配置資源和通訊機制。 開發新的 WinSNMP 應用程式時，建議您呼叫 SnmpCreateSession 函式來開啟 WinSNMP 會話，而不是呼叫 SnmpOpen 函式。
SnmpRecvMsg 傳回 SNMP 訊息和未處理的陷阱資料和通知。
SnmpRegister 通知實作應用程式必須註冊或取消註冊陷阱和通知。
SnmpSendMsg 要求實作傳輸通訊協定資料單位。
SnmpStartup 通知實作執行應用程式的初始化程式。 應用程式必須先成功呼叫 SnmpStartup 函式，才能呼叫任何其他 WinSNMP 函式。
SnmpStartupEx 通知 Microsoft WinSNMP 實作 WinSNMP 應用程式需要實作的服務。 SnmpStartupEx 可支援在相同應用程式中使用 WinSNMP 的多個獨立軟體模組。
SNMPAPI_CALLBACK 通知 WinSNMP 會話 SNMP 訊息或非同步事件可供使用。 注意： 此回呼函式只適用于因為呼叫 SnmpCreateSession 函式而開啟的會話。

WinSNMP 實體和內容函式

WinSNMP 實體和內容函式可讓 WinSNMP 應用程式指定 SNMP 實體和內容的使用者易記名稱。 Microsoft WinSNMP 實作會使用實作的資料庫，將名稱轉譯為其 SNMPv1 或 SNMPv2C 元件。

函式 描述
SnmpCoNtextToStr 傳回字串，識別一組 Managed 物件資源 (SNMP 內容) 。
SnmpEntityToStr 傳回識別 SNMP 管理實體的字串。
SnmpFreeCoNtext 釋放 SnmpStrToCoNtext 函式針對 SNMP 內容所配置的資源。
SnmpFreeEntity 釋放 SnmpStrToEntity 函式針對 SNMP 管理實體所配置的資源。
SnmpSetPort 變更指派給 SNMP 目的地實體的埠。
SnmpStrToCoNtext 傳回實作特有的 SNMP 內容資訊的控制碼。
SnmpStrToEntity 傳回實作專屬的 SNMP 管理實體資訊的控制碼。

WinSNMP 資料庫函式

WinSNMP 資料庫函式提供 WinSNMP 應用程式，可存取 Microsoft WinSNMP 實作系統管理資訊存放區中的目前設定。 這些函式允許變更重新傳輸模式和實體和內容轉譯模式。 資料庫函式也會讓應用程式能夠操作逾時和重試計數值。

函式 描述
SnmpGetRetransmitMode 傳回重新傳輸模式的目前設定。
SnmpGetRetry 傳回重新傳輸 SNMP 訊息要求的重試計數值單位。
SnmpGetTimeout 傳回 SNMP 訊息要求的傳輸時，以百分之一秒為單位的逾時值。
SnmpGetTranslateMode 傳回實體和內容轉譯模式的目前設定。
SnmpGetVendorInfo 擷取識別 WinSNMP 廠商的資訊。
SnmpSetRetransmitMode 變更重新傳輸模式。
SnmpSetRetry 變更重新傳輸 SNMP 訊息要求的重試計數值。
SnmpSetTimeout 變更 SNMP 訊息要求的傳輸逾時值。
SnmpSetTranslateMode 變更實體和內容轉譯模式。

WinSNMP PDU 函式

WinSNMP PDU 函式可讓 WinSNMP 應用程式擷取和更新 PDU (或欄位) 的資料元素。 這包括呼叫 SnmpRecvMsg 函式或 SnmpDecodeMsg 函式所傳回的 PDU。 PDU 函式也會建構 PDU，以用於 SnmpSendMsg 和 SnmpEncodeMsg 函式。

函式 描述
SnmpCreatePdu 建立並初始化 SNMP 通訊協定資料單位。
SnmpDuplicatePdu 複製 SNMP 通訊協定資料單位。
SnmpFreePdu 釋放與 SnmpCreatePdu 或 SnmpDuplicatePdu 函式所建立之 SNMP 通訊協定資料單位相關聯的資源。
SnmpGetPduData 從指定的 SNMP 通訊協定資料單位傳回選取的資料元素。
SnmpSetPduData 更新指定 SNMP 通訊協定資料單位中選取的資料元素。

WinSNMP 公用程式函式

WinSNMP 公用程式函式可讓 WinSNMP 應用程式跨 WinSNMP 介面管理物件和 SNMP 訊息。

函式 描述
SnmpDecodeMsg 將編碼或序列化的 SNMP 訊息解碼為其組成元件。
SnmpEncodeMsg 建立編碼的 SNMP 訊息。
SnmpFreeDescriptor 發出 Microsoft WinSNMP 實作的訊號，指出它應該釋放配置給特定描述元的記憶體。
SnmpGetLastError 傳回最後一個 SNMP 作業的最後一個錯誤碼值。
SnmpOidCompare 比較兩個 SNMP 物件識別碼。
SnmpOidCopy 複製 SNMP 物件識別碼。
SnmpOidToStr 將 SNMP 物件識別碼的內部二進位表示轉換為其虛線數值字串格式。
SnmpStrToOid 將 SNMP 物件識別碼的虛線數值字串格式轉換為其內部二進位表示。

WinSNMP 變數系結函式

WinSNMP 變數系結函式可讓 WinSNMP 應用程式建構及操作變數系結清單，並將其包含在 PTU 中。

函式 描述
SnmpCountVbl 列舉指定之變數系結清單中的變數系結專案。
SnmpCreateVbl 建立新的變數系結清單。
SnmpDeleteVb 從變數系結清單中移除變數系結專案。
SnmpDuplicateVbl 複製變數系結清單。
SnmpFreeVbl 釋放 先前由 SnmpCreateVbl 或 SnmpDuplicateVbl 函式配置之變數系結清單的資源。
SnmpGetVb 從指定的變數系結專案擷取資訊。
SnmpSetVb 變更變數系結清單中的變數系結專案;將新的變數系結專案附加至現有的變數系結清單。

WinSNMP 函式字母清單