SnmpExtensionMonitor-Funktion (snmp.h)
[SNMP ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt "Anforderungen" angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen die Windows-Remoteverwaltung, die Microsoft-Implementierung von WS-Man.]
Der Microsoft SNMP-Dienst ruft die SnmpExtensionMonitor-Funktion auf, um dem SNMP-Erweiterungs-Agent eine Sicht auf die internen Leistungsindikatoren und Parameter des Diensts bereitzustellen. Diese Funktion ist ein Element der SNMP-Erweiterungs-Agent-API.
Die SnmpExtensionMonitor-Funktion ist optional. Erweiterungs-Agents sollten die Funktion implementieren, wenn sie an einer Ansicht der internen Verwaltungsobjekte des SNMP-Diensts interessiert sind, wie in RFC 1213, "Verwaltungsinformationsbasis für die Netzwerkverwaltung von TCP/IP-basierten Internets: MIB-II" definiert.
Syntax
BOOL SNMP_FUNC_TYPE SnmpExtensionMonitor(
[in] LPVOID pAgentMgmtData
);
Parameter
[in] pAgentMgmtData
Zeiger auf ein Array von AsnAny-Objekten (Strukturen). Die Anzahl der Objekte sowie der Typ und die Beschreibung der einzelnen Objekte entsprechen RFC 1213. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
Rückgabewert
Sofern beim Verarbeiten des Werts des pAgentMgmtData-Parameters vom SNMP-Erweiterungs-Agent kein unerwarteter Fehler auftritt, sollte der Erweiterungs-Agent TRUE zurückgeben. Wenn der Erweiterungs-Agent FALSE zurückgibt, lädt der SNMP-Dienst den Erweiterungs-Agent nicht, und der Dienst beendet die Weiterleitung von SNMP-Anforderungen an den Erweiterungs-Agent.
Hinweise
Wenn der Erweiterungs-Agent die Funktion SnmpExtensionMonitor exportiert, ruft der SNMP-Dienst die Funktion während der Initialisierung des Erweiterungs-Agents auf, unmittelbar nachdem der Dienst die SnmpExtensionInit - und die SnmpExtensionInitExit-Funktionen aufgerufen hat.
Der SNMP-Dienst aktualisiert dynamisch die SNMP-Indikatoren (z. B. die Indikatoren snmpInPkts und snmpOutNoSuchNames) in dem Array, auf das vom pAgentMgmtData-Parameter verwiesen wird. Damit diese Werte während der Ausführung des SNMP-Diensts gelesen werden können, muss der Erweiterungs-Agent den Zeiger auf pAgentMgmtData speichern.
Beachten Sie, dass ein SNMP-Erweiterungs-Agent den Arbeitsspeicher, auf den der pAgentMgmtData-Parameter verweist, nicht aktualisieren sollte. Dies liegt daran, dass die Werte der internen Indikatoren des SNMP-Diensts nicht mehr gültig wären und das Verhalten des SNMP-Diensts unvorhersehbar werden könnte. Solange der Erweiterungs-Agent ihn nicht ändert, ist der Speicher, auf den pAgentMgmtData verweist, gültig, während der SNMP-Dienst ausgeführt wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | snmp.h |