snmpExtensionMonitor 函式 (snmp.h)
[SNMP 可用於需求一節中指定的作業系統。 它在後續版本中可能會變更或無法使用。 請改用 Windows 遠端管理，這是 WS-Man 的 Microsoft 實作。
Microsoft SNMP 服務會呼叫 SnmpExtensionMonitor 函式，以提供 SNMP 擴充代理程式與服務內部計數器和參數的檢視。 此函式是SNMP擴充代理程式 API 的元素。
SnmpExtensionMonitor 函式是選擇性的。 如果擴充代理程式對SNMP服務內部管理物件的檢視感興趣，則擴充代理程式應該實作函式，如 RFC 1213「管理 TCP/IP 型因特網的網路管理資訊基底：MIB-II」中所定義。
語法
BOOL SNMP_FUNC_TYPE SnmpExtensionMonitor(
[in] LPVOID pAgentMgmtData
);
參數
[in] pAgentMgmtData
AsnAny 物件的陣列指標 (結構) 。 物件數目，以及每個物件的類型和描述，都是根據 RFC 1213。 如需詳細資訊，請參閱接下來的＜備註＞一節。
傳回值
除非 SNMP 擴充代理程式正在處理 pAgentMgmtData 參數的值時發生非預期的錯誤，否則延伸模組代理程式應該會傳回 TRUE。 如果擴充代理程式傳回 FALSE，SNMP 服務不會載入擴充代理程式，而服務會停止將 SNMP 要求導向至延伸模組代理程式。
備註
如果擴充代理程式導出SnmpExtensionMonitor 函式，SNMP 服務會在擴充代理程式的初始化期間立即呼叫函式，緊接在服務呼叫 SnmpExtensionInit 和 SnmpExtensionInitEx 函式之後。
SNMP 服務會 (動態更新 SNMP 計數器，例如， pAgentMgmtData 參數所指向陣列中的 snmpInPkts 和 snmpOutNoSuchNames 計數器) 。 為了能夠在SNMP服務執行時讀取這些值，延伸模組代理程序必須儲存 pAgentMgmtData 的指標。
請注意，SNMP 擴充代理程式不應該更新 pAgentMgmtData 參數所指向的記憶體。 這是因為 SNMP 服務的內部計數器值不再有效，而且 SNMP 服務的行為可能會變得無法預期。 只要擴充代理程式未改變它， pAgentMgmtData 所指向的記憶體在執行 SNMP 服務時就有效。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | snmp.h |