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
SNMPAPI_NOT_INITIALIZED	Die SnmpStartup-Funktion wurde nicht erfolgreich abgeschlossen.
SNMPAPI_ALLOC_ERROR	Während der Speicherzuordnung ist ein Fehler aufgetreten.
SNMPAPI_SESSION_INVALID	Der Sitzungsparameter ist ungültig.
SNMPAPI_OTHER_ERROR	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

Weitere Informationen

SnmpCleanup

SnmpCreateSession

WinSNMP-Funktionen

Übersicht über die WinSNMP-API