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 |
|---|---|
|
La funzione SnmpStartup non è stata completata correttamente. |
|
Errore durante l'allocazione della memoria. |
|
Il parametro di entità non è valido. |
|
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 |