Condividi tramite


Funzione SnmpFreeEntity (winsnmp.h)

[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

Vedi anche

SnmpCleanup

SnmpClose

SnmpStrToEntity

Funzioni WinSNMP

Panoramica dell'API WinSNMP