snmpMgrGetTrapEx 函式 (mgmtapi.h)

發行項
03/05/2024

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

如果啟用陷阱接收， SnmpMgrGetTrapEx 函式會傳回呼叫端尚未收到的未處理陷阱數據。除了 SnmpMgrGetTrap 函式所傳回的資訊之外，這個擴充函式還會傳回傳輸來源的位址和陷阱的社群字串。此函式是SNMP管理 API 的元素。

語法

BOOL SNMP_FUNC_TYPE SnmpMgrGetTrapEx(
  [out] AsnObjectIdentifier *enterprise,
  [out] AsnNetworkAddress   *agentAddress,
  [out] AsnNetworkAddress   *sourceAddress,
  [out] AsnInteger          *genericTrap,
  [out] AsnInteger          *specificTrap,
  [out] AsnOctetString      *community,
  [out] AsnTimeticks        *timeStamp,
  [out] RFC1157VarBindList  *variableBindings
);

參數

[out] enterprise

AsnObjectIdentifier 結構的指標，以接收產生 SNMP 陷阱的企業。

[out] agentAddress

要接收產生SNMP 陷阱之代理程式位址之變數的指標;此資訊是從 SNMP 通訊協定數據單位擷取， (PDU) 。

[out] sourceAddress

要接收產生SNMP 陷阱之代理程式位址之變數的指標;這項資訊是從網路傳輸擷取而來。

[out] genericTrap

要接收泛型陷阱指標之變數的指標。此參數可以是下列其中一個值。

值	意義
SNMP_GENERICTRAP_COLDSTART	代理程式正在初始化Managed模式上的通訊協議實體。它可以在其檢視中改變物件。
SNMP_GENERICTRAP_WARMSTART	代理程式正在重新初始化本身，但不會在其檢視中改變物件。
SNMP_GENERICTRAP_LINKDOWN	附加的介面已從向上狀態變更為關閉狀態。變數系結清單中的第一個變數會識別介面。
SNMP_GENERICTRAP_LINKUP	附加的介面已從關閉狀態變更為向上狀態。變數系結清單中的第一個變數會識別介面。
SNMP_GENERICTRAP_AUTHFAILURE	SNMP 實體已傳送 SNMP 訊息，但誤報屬於已知的社群。
SNMP_GENERICTRAP_EGPNEIGHLOSS	EGP 對等互連已變更為關閉狀態。變數系結清單中的第一個變數會識別 EGP 對等的IP位址。
SNMP_GENERICTRAP_ENTERSPECIFIC	發生異常事件。其識別於具有企業特定值的 specificTrap 參數中。

[out] specificTrap

要接收所產生特定陷阱指標之變數的指標。

[out] community

AsnOctetString 結構的指標，以接收所產生 SNMP 陷阱的社群字串。

[out] timeStamp

要接收時間戳之變數的指標。

[out] variableBindings

要接收變數系結清單之 SnmpVarBindList 結構的指標。

傳回值

如果函式傳回陷阱，則傳回值為非零值。

您應該重複呼叫 SnmpMgrGetTrapEx 函 式，直到傳回零為止。函式也可以傳回下列錯誤碼。

傳回碼	Description
SNMP_MGMTAPI_TRAP_ERRORS	指出發生錯誤;無法存取陷阱。
SNMP_MGMTAPI_NOTRAPS	表示沒有可用的陷阱。
SNMP_MEM_ALLOC_ERROR	表示記憶體配置錯誤。

備註

應用程式必須先呼叫 SnmpMgrTrapListen 函式，再呼叫 SnmpMgrGetTrapEx 函 式。這是因為 SnmpMgrTrapListen 函式的 phTrapAvailable 參數所指向的事件句柄可啟用 SNMP 陷阱的事件驅動擷取。 SNMP 管理 API 會在 SNMP 陷阱服務提供陷阱時發出應用程式事件的訊號。

應用程式也可以定期輪詢 SnmpMgrGetTrapEx 函 式以取得陷阱。在此情況下，應用程式應該重複呼叫 SnmpMgrGetTrapEx ，直到函式傳回零為止。

規格需求

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