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 |
|---|---|
|
Die SnmpStartup-Funktion wurde nicht erfolgreich abgeschlossen. |
|
Während der Speicherbelegung ist ein Fehler aufgetreten. |
|
Der Kontextparameter ist ungültig. |
|
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 |