SnmpClose-Funktion (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 SnmpClose-Funktion ermöglicht der Microsoft WinSNMP-Implementierung die Zuordnung von Arbeitsspeicher, Ressourcen und Datenstrukturen, die einer WinSNMP-Sitzung zugeordnet sind. Die WinSNMP SnmpClose-Funktion schließt auch Kommunikationsmechanismen, die die Implementierung durch einen Aufruf der SnmpCreateSession-Funktion geöffnet hat.
Syntax
SNMPAPI_STATUS SNMPAPI_CALL SnmpClose(
[in] HSNMP_SESSION session
);
Parameter
[in] session
Handle, um die WinSNMP-Sitzung zu schließen.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert SNMPAPI_SUCCESS.
Wenn die Funktion fehlschlägt, wird der Rückgabewert SNMPAPI_FAILURE. Um erweiterte Fehlerinformationen abzurufen, rufen Sie SnmpGetLastError auf, indem Sie einen NULL-Wert im Sitzungsparameter angeben. Die SnmpGetLastError-Funktion kann einen der folgenden Fehler zurückgeben.
| Rückgabecode | Beschreibung |
|---|---|
|
Die SnmpStartup-Funktion wurde nicht erfolgreich abgeschlossen. |
|
Während der Speicherzuordnung ist ein Fehler aufgetreten. |
|
Der Sitzungsparameter ist ungültig. |
|
Ein unbekannter oder nicht definierter Fehler ist aufgetreten. |
Hinweise
Es wird empfohlen, dass eine WinSNMP-Anwendung die SnmpClose-Funktion einmal für jede Sitzung aufruft, die die Anwendung mit der SnmpCreateSession-Funktion geöffnet hat. Wenn eine WinSNMP-Anwendung unerwartet beendet wird, muss sie SnmpCleanup aufrufen, bevor sie beendet wird, damit die Implementierung alle Ressourcen zugeordnet werden kann. Die Implementierung verarbeitet einen SnmpCleanup-Aufruf wie eine Reihe von SnmpClose-Aufrufen , einen Aufruf für jede Sitzung, die als Ergebnis eines Aufrufs von SnmpCreateSession geöffnet wurde.
Wenn die Implementierung eine Sitzung schließt, verwirft sie alle ausstehenden eingehenden und ausgehenden asynchronen Anforderungen und Antworten für die Sitzung. Weitere Informationen finden Sie unter WinSNMP-Sitzungen.
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 |
| Bibliothek | Wsnmp32.lib |
| DLL | Wsnmp32.dll |