Öffnen und Schließen einer WinSNMP-Sitzung

Um eine Sitzung zu öffnen, ruft eine Anwendung die SnmpCreateSession-Funktion auf. Wenn die Funktion erfolgreich abgeschlossen wurde, öffnet die Microsoft WinSNMP-Implementierung eine Sitzung, und die Funktion gibt einen Sitzungsbezeichner in Form eines HSNMP _ SESSION-Handles zurück. Alle WinSNMP-Funktionen, die Handlevariablen zurückgeben, enthalten den Sitzungsbezeichner als Eingabeparameter. Dadurch kann die Implementierung das Handle verwenden, um Ressourcen effizient auf Sitzungsebene zu verwalten.

Für eine Anwendung können mehrere Sitzungen gleichzeitig geöffnet sein. Mehrere Sitzungen innerhalb einer Anwendung können Handlevariablen gemeinsam nutzen.

Wenn die Implementierung aufgrund von Ressourceneinschränkungen keine Sitzung öffnen kann, wird SNMPAPI _ FAILURE zurückgegeben, wenn die Anwendung SnmpCreateSession aufruft. Wenn die Anwendung dann die SnmpGetLastError-Funktion aufruft, wird SNMPAPI _ ALLOC _ ERROR zurückgegeben.

Durch einen Aufruf der SnmpClose-Funktion kann die Implementierung alle verbleibenden Ressourcen freigeben und die Sitzung schließen.

Weitere Informationen finden Sie unter Ressourcenhandleobjekte und WinSNMP-Sitzungen.