SnmpFreeVbl-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-SnmpFreeVbl-Funktion gibt Ressourcen frei, die einer Variablenbindungsliste zugeordnet sind. Dies sind Ressourcen, die zuvor durch einen Aufruf der SnmpCreateVbl-Funktion oder der SnmpDuplicateVbl-Funktion in einer WinSNMP-Anwendung zugeordnet wurden.
Syntax
SNMPAPI_STATUS SNMPAPI_CALL SnmpFreeVbl(
[in] HSNMP_VBL vbl
);
Parameter
[in] vbl
Handle für die zu releasede Variablenbindungsliste.
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 vbl-Parameter ist ungültig. |
|
Es ist ein unbekannter oder nicht definierter Fehler aufgetreten. |
Hinweise
Die WinSNMP-Anwendung muss die Ressourcen freigeben, die jeder Variablenbindungsliste zugeordnet sind. Dazu sollte jeder Aufruf der Funktionen SnmpCreateVbl und SnmpDuplicateVbl mit einem entsprechenden Aufruf der SnmpFreeVbl-Funktion übereinstimmen. Um Speicherverluste zu vermeiden, muss eine WinSNMP-Anwendung SnmpFreeVbl aufrufen, bevor sie das Handle in einer Variablenbindungsliste in einem nachfolgenden Aufruf von SnmpCreateVbl oder SnmpDuplicateVbl wiederverwendet.
Wenn die Anwendung die SnmpClose - oder snmpCleanup-Funktion aufruft, gibt die Microsoft WinSNMP-Implementierung alle Ressourcen frei, die sie für die WinSNMP-Sitzung ordnet. Auch wenn die Anwendung kein Listenhandle für Variablenbindungen wiederverwendet, wird empfohlen, dass die Anwendung ressourcen für einzelne Variablenbindungen mit der SnmpFreeVbl-Funktion freigibt. Dies reduziert die Arbeitslast der Implementierung und sollte den Dienst 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 |