SnmpFreeContext-Funktion (winsnmp.h)

[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 WinSNMP-SnmpFreeContext-Funktion gibt Ressourcen frei, die einem SNMP-Kontext zugeordnet sind, bei dem es sich um eine Gruppe verwalteter Objektressourcen handelt.

Syntax

SNMPAPI_STATUS SNMPAPI_CALL SnmpFreeContext(
  [in] HSNMP_CONTEXT context
);

Parameter

[in] context

Handle für den SNMP-Kontext, für den die Ressourcen freigegeben werden.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert SNMPAPI_SUCCESS.

Wenn die Funktion fehlschlägt, wird der Rückgabewert SNMPAPI_FAILURE. Rufen Sie SnmpGetLastError auf, um erweiterte Fehlerinformationen zu erhalten, und geben Sie einen NULL-Wert im Sitzungsparameter an. 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 Speicherbelegung ist ein Fehler aufgetreten.
SNMPAPI_CONTEXT_INVALID
Der Kontextparameter ist ungültig.
SNMPAPI_OTHER_ERROR
Es ist ein unbekannter oder nicht definierter Fehler aufgetreten.

Hinweise

Wenn die WinSNMP-Anwendung die SnmpClose-Funktion oder die SnmpCleanup-Funktion aufruft, gibt die Microsoft WinSNMP-Implementierung alle Ressourcen frei, die sie für die WinSNMP-Sitzung zugewiesen hat. Es wird jedoch empfohlen, dass die WinSNMP-Anwendung einzelne Ressourcen mit der WinSNMP-Funktion freigibt, die der Ressource entspricht. Anwendungen sollten beispielsweise die SnmpFreeContext-Funktion aufrufen, um Ressourcen freizugeben, die durch einen Aufruf der SnmpStrToContext-Funktion zugewiesen wurden. Dies reduziert die Arbeitslast der Implementierung und sollte den Dienst der Implementierung für alle Anwendungen verbessern.

Weitere Informationen finden Sie unter WinSNMP Datenverwaltung Concepts.

Anforderungen

   
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

SnmpClose

SnmpStrToContext

WinSNMP-Funktionen

Übersicht über winSNMP-API