SnmpMgrClose-Funktion (mgmtapi.h)

  • Artikel

[SNMP ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen die Windows-Remoteverwaltung, die Microsoft-Implementierung von WS-Man.]

Die SnmpMgrClose-Funktion schließt die Kommunikationssockets und Datenstrukturen, die der angegebenen Sitzung zugeordnet sind. Diese Funktion ist ein Element der SNMP-Verwaltungs-API.

Syntax

BOOL SNMP_FUNC_TYPE SnmpMgrClose(
  [in] LPSNMP_MGR_SESSION session
);

Parameter

[in] session

Zeiger auf eine interne Struktur, die die zu schließende Sitzung angibt. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Diese Funktion gibt möglicherweise Windows Sockets-Fehlercodes zurück.

Hinweise

Windows Server 2003: SNMP-Manager-Anwendungen können SnmpMgrClose mit einem NULL-Sitzungsparameter aufrufen, um die Ressourcen zu sauber, die einem erfolgreichen Aufruf der SnmpMgrTrapListen-Funktion zugeordnet sind. Beachten Sie jedoch, dass Ihre Anwendung, wenn es sich um eine DLL handelt, snmpMgrClose nicht über die DllMain-Einstiegspunktfunktion aufrufen sollte.

SnmpMgrClose darf nicht aufgerufen werden, wenn die Anwendungs-DLL gerade entladen wird.

Windows Server 2003: Die Ausführung von SnmpMgrClose unter Windows Server 2003 dauert länger als bei einem identischen Aufruf unter Windows 2000. Insbesondere dauert die Ausführung eines Aufrufs dieser API unter Windows Server 2003 bis zu einer Sekunde, während der gleiche Aufruf unter Windows 2000 etwa 0,3 Millisekunden dauert. Dies kann zu Leistungsproblemen für Windows Server 2003-SNMP-Anwendungen führen, die snmpMgrOpen und SnmpMgrClose häufig aufrufen.

Um dieses Problem zu beheben, erstellen Sie eine zusätzliche SNMP-Manager-Sitzung, indem Sie snmpMgrOpen während des Anwendungsstarts auf dem lokalen Host aufrufen, und lassen Sie sie für die Dauer der Anwendungslebensdauer geöffnet. Durch das Schließen des Sitzungs-Managers werden alle zugehörigen Sitzungen geschlossen, sodass nur ein Aufruf von SnmpMgrClose erforderlich ist.

Windows Server 2003 mit SP1: Das obige Problem gilt nicht für Windows 2003 Service Pack 1.

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 mgmtapi.h
Bibliothek Mgmtapi.lib
DLL Mgmtapi.dll

Weitere Informationen

SNMP-Funktionen

Simple Network Management-Protokoll (SNMP) – Übersicht

SnmpMgrOpen

SnmpMgrRequest