SNMPAPI_CALLBACK Rückruffunktion (winsnmp.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 Microsoft WinSNMP-Implementierung ruft die SNMPAPI_CALLBACK-Funktion auf, um eine WinSNMP-Sitzung darüber zu benachrichtigen, dass eine SNMP-Nachricht oder ein asynchrones Ereignis verfügbar ist.
SNMPAPI_CALLBACK ist ein Platzhalter für einen anwendungs- oder bibliotheksdefinierten Rückruffunktionsnamen.
Syntax
SNMPAPI_CALLBACK SnmpapiCallback;
SNMPAPI_STATUS SnmpapiCallback(
[in] HSNMP_SESSION hSession,
[in] HWND hWnd,
[in] UINT wMsg,
[in] WPARAM wParam,
[in] LPARAM lParam,
[in] LPVOID lpClientData
)
{...}
Parameter
[in] hSession
Handle mit der WinSNMP-Sitzung.
[in] hWnd
Behandeln Sie ein Fenster der WinSNMP-Anwendung, um zu benachrichtigen, wenn eine asynchrone Anforderung abgeschlossen ist oder wenn eine Trapbenachrichtigung auftritt. Dieser Parameter hat keine Bedeutung für die WinSNMP-Sitzung, aber die Implementierung übergibt den Wert immer an die Rückruffunktion.
[in] wMsg
Gibt eine ganzzahlige Zahl ohne Vorzeichen an, die die Benachrichtigung an das WinSNMP-Anwendungsfenster senden soll. Dieser Parameter hat keine Bedeutung für die WinSNMP-Sitzung, aber die Implementierung übergibt den Wert immer an die Rückruffunktion.
[in] wParam
Gibt einen anwendungsdefinierten 32-Bit-Wert an, der den Benachrichtigungstyp identifiziert. Wenn dieser Parameter gleich 0 ist, ist eine SNMP-Nachricht für die Sitzung verfügbar. Die Anwendung sollte die SnmpRecvMsg-Funktion aufrufen, um die Nachricht abzurufen. Wenn dieser Parameter nicht gleich 0 ist, gibt er eine asynchrone Ereignisbenachrichtigung für die Sitzung an. Weitere Informationen finden Sie im abschnitt "Hinweise".
[in] lParam
Gibt einen anwendungsdefinierten 32-Bit-Wert an, der den Anforderungsbezeichner der verarbeiteten PDU angibt.
[in] lpClientData
Wenn der lpClientData-Parameter beim Aufruf der SnmpCreateSession-Funktion für diese Sitzung nicht NULL war, ist dieser Parameter ein Zeiger auf anwendungsdefinierte Daten.
Rückgabewert
Die Funktion muss SNMPAPI_SUCCESS zurückgeben, um die Ausführung der Anwendung fortzusetzen. Wenn die Funktion einen anderen Wert zurückgibt, reagiert die Implementierung so, als hätte die Anwendung die SnmpClose-Funktion für die angegebene Sitzung aufgerufen.
Hinweise
Wenn die Implementierung die Erneutübertragungsrichtlinie für die WinSNMP-Anwendung ausführt und ein Timeout für die Übertragung auftritt, informiert die Implementierung die Sitzung über den Fehler. In dieser Situation wird der Wert des wParam-Parameters SNMPAPI_TL_TIMEOUT. Eine Liste mit anderen Transportschichtfehlern finden Sie auf den Referenzseiten für die Funktionen SnmpRegister, SnmpSendMsg und SnmpRecvMsg .
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 | winsnmp.h |