SnmpMgrTrapListen-Funktion (mgmtapi.h)
[SNMP ist für die Verwendung in den im Abschnitt "Anforderungen" angegebenen Betriebssystemen verfügbar. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen die Windows-Remoteverwaltung, die die Microsoft-Implementierung von WS-Man ist.]
Die SnmpMgrTrapListen-Funktion registriert die Fähigkeit einer SNMP-Manager-Anwendung, SNMP-Traps vom SNMP Trap Service zu empfangen. Diese Funktion ist ein Element der SNMP-Verwaltungs-API.
Syntax
BOOL SNMP_FUNC_TYPE SnmpMgrTrapListen(
[out] HANDLE *phTrapAvailable
);
Parameter
[out] phTrapAvailable
Zeiger auf ein Ereignishandle, um einen Hinweis darauf zu erhalten, dass Traps verfügbar sind, und dass die Anwendung die SnmpMgrGetTrap-Funktion aufrufen soll.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Rufen Sie getLastError auf, um erweiterte Fehlerinformationen abzurufen, die einen der folgenden Fehlercodes zurückgeben können.
| Rückgabecode | Beschreibung |
|---|---|
|
Gibt einen Speicherzuweisungsfehler an. |
|
Gibt an, dass diese Funktion bereits aufgerufen wurde. |
|
Gibt einen oder mehrere Fehler an; Traps sind nicht zugänglich. Die Anwendung kann versuchen, die Funktion erneut aufzurufen. |
Diese Funktion gibt möglicherweise auch andere Systemfehler zurück.
Hinweise
Es ist wichtig zu beachten, dass für Benutzer, die keine Administratoren sind, die SnmpMgrTrapListen-Funktion nur erfolgreich ist, wenn der SNMP-Trapdienst gestartet wurde.
Die Anwendung muss immer die SnmpMgrTrapListen-Funktion aufrufen, bevor die SnmpMgrGetTrap-Funktion aufgerufen wird . Dies liegt daran, dass der ereignisgesteuerte Erwerb von SNMP-Traps durch den phTrapAvailable-Parameter verweist. Die SNMP-Verwaltungs-API signalisiert das Ereignis einer Anwendung, wenn der SNMP Trap Service eine Trap liefert.
Die Anwendung kann auch die SnmpMgrGetTrap-Funktion für Traps in regelmäßigen Abständen abfragen. In diesem Fall sollte die Anwendung wiederholt SnmpMgrGetTrap aufrufen, bis die Funktion null zurückgibt.
Windows Server 2003: SNMP-Manageranwendungen können SnmpMgrClose mit einem NULL-Sitzungsparameter aufrufen, um Ressourcen zu bereinigen, die einem erfolgreichen Aufruf der SnmpMgrTrapListen-Funktion zugeordnet sind. Beachten Sie jedoch, dass, wenn Ihre Anwendung eine DLL ist, nicht snmpMgrClose aus seiner DllMain-Einstiegspunktfunktion aufrufen sollte.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | mgmtapi.h |
| Bibliothek | Mgmtapi.lib |
| DLL | Mgmtapi.dll |