SnmpMgrTrapListen-Funktion (mgmtapi.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.]

Die SnmpMgrTrapListen-Funktion registriert die Fähigkeit einer SNMP-Manager-Anwendung, SNMP-Traps vom SNMP-Trap-Dienst 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. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf, die möglicherweise einen der folgenden Fehlercodes zurückgeben.

Rückgabecode	Beschreibung
SNMP_MEM_ALLOC_ERROR	Gibt einen Fehler bei der Speicherzuordnung an.
SNMP_MGMTAPI_TRAP_DUPINIT	Gibt an, dass diese Funktion bereits aufgerufen wurde.
SNMP_MGMTAPI_TRAP_ERRORS	Gibt an, dass mindestens ein Fehler aufgetreten ist. Traps sind nicht zugänglich. Die Anwendung kann versuchen, die Funktion erneut aufzurufen.

 

Diese Funktion kann auch andere Systemfehler zurückgeben.

Hinweise

Es ist wichtig zu beachten, dass für Benutzer, die keine Administratoren sind, die SnmpMgrTrapListen-Funktion nur erfolgreich ist, wenn der SNMP-Trap-Dienst gestartet wurde.

Die Anwendung muss immer die SnmpMgrTrapListen-Funktion aufrufen, bevor sie die SnmpMgrGetTrap-Funktion aufruft . Dies liegt daran, dass das Ereignishandle, auf das vom parameter phTrapAvailable verwiesen wird, die ereignisgesteuerte Erfassung von SNMP-Traps ermöglicht. Die SNMP Management-API signalisiert das Ereignis einer Anwendung, wenn der SNMP-Trap-Dienst eine Trap übermittelt.

Die Anwendung kann auch die SnmpMgrGetTrap-Funktion in regelmäßigen Abständen auf Traps 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 sauber, die einem erfolgreichen Aufruf der SnmpMgrTrapListen-Funktion zugeordnet sind. Beachten Sie jedoch, dass Ihre Anwendung, wenn es sich um eine DLL handelt, snmpMgrClose nicht über die DllMain-Einstiegspunktfunktion aufrufen sollte.

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	mgmtapi.h
Bibliothek	Mgmtapi.lib
DLL	Mgmtapi.dll

Weitere Informationen

SNMP-Funktionen

Simple Network Management-Protokoll (SNMP) – Übersicht

SnmpMgrGetTrap