SnmpFreeEntity-Funktion (winsnmp.h)

Artikel
03/04/2024

[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-SnmpFreeEntity-Funktion gibt Ressourcen frei, die einer SNMP-Verwaltungsentität zugeordnet sind.

Syntax

SNMPAPI_STATUS SNMPAPI_CALL SnmpFreeEntity(
  [in] HSNMP_ENTITY entity
);

Parameter

[in] entity

Handle für die SNMP-Verwaltungsentität, für die ihre 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_ENTITY_INVALID	Der Entitätsparameter 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 mithilfe der WinSNMP-Funktion freigibt, die der Ressource entspricht. Beispielsweise sollten Anwendungen die SnmpFreeEntity-Funktion aufrufen, um Ressourcen freizugeben, die durch einen Aufruf der SnmpStrToEntity-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

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	winsnmp.h
Bibliothek	Wsnmp32.lib
DLL	Wsnmp32.dll

Weitere Informationen

Übersicht über winSNMP-API