Funzione SnmpFreeEntity (winsnmp.h)

Articolo
03/04/2024

[SNMP è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Usare invece Gestione remota Windows, ovvero l'implementazione Microsoft di WS-Man.

La funzione SnmpFreeEntity WinSNMP rilascia risorse associate a un'entità di gestione SNMP.

Sintassi

SNMPAPI_STATUS SNMPAPI_CALL SnmpFreeEntity(
  [in] HSNMP_ENTITY entity
);

Parametri

[in] entity

Gestire l'entità di gestione SNMP che avrà le relative risorse rilasciate.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è SNMPAPI_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è SNMPAPI_FAILURE. Per ottenere informazioni sull'errore estese, chiamare SnmpGetLastError specificando un valore NULL nel relativo parametro di sessione . La funzione SnmpGetLastError può restituire uno degli errori seguenti.

Codice restituito	Descrizione
SNMPAPI_NOT_INITIALIZED	La funzione SnmpStartup non è stata completata correttamente.
SNMPAPI_ALLOC_ERROR	Errore durante l'allocazione della memoria.
SNMPAPI_ENTITY_INVALID	Il parametro di entità non è valido.
SNMPAPI_OTHER_ERROR	Si è verificato un errore sconosciuto o non definito.

Commenti

Quando l'applicazione WinSNMP chiama la funzione SnmpClose o la funzione SnmpCleanup , l'implementazione Di Microsoft WinSNMP libera tutte le risorse allocate per la sessione WinSNMP. È tuttavia consigliabile che l'applicazione WinSNMP libera le singole risorse usando la funzione WinSNMP corrispondente alla risorsa. Ad esempio, le applicazioni devono chiamare la funzione SnmpFreeEntity per rilasciare le risorse allocate da una chiamata alla funzione SnmpStrToEntity . Ciò riduce il carico di lavoro dell'implementazione e deve migliorare il servizio dell'implementazione a tutte le applicazioni.

Per altre informazioni, vedere Concetti di Gestione dati WinSNMP.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winsnmp.h
Libreria	Wsnmp32.lib
DLL	Wsnmp32.dll