Freigeben über


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

Weitere Informationen

SnmpCleanup

SnmpClose

SnmpCreateVbl

SnmpDuplicateVbl

WinSNMP-Funktionen

Übersicht über winSNMP-API