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

Weitere Informationen

SnmpClose

SnmpCreateSession

WinSNMP-Funktionen

Übersicht über die WinSNMP-API