SnmpFreeEntity-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-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 |
|---|---|
|
Die SnmpStartup-Funktion wurde nicht erfolgreich abgeschlossen. |
|
Während der Speicherbelegung ist ein Fehler aufgetreten. |
|
Der Entitätsparameter 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 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 |