Funzione SnmpFreeContext (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 SnmpFreeContext WinSNMP rilascia le risorse associate a un contesto SNMP, ovvero un set di risorse oggetto gestite.
Sintassi
SNMPAPI_STATUS SNMPAPI_CALL SnmpFreeContext(
[in] HSNMP_CONTEXT context
);
Parametri
[in] context
Gestire il contesto SNMP che avrà le relative risorse rilasciate.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene SNMPAPI_SUCCESS.
Se la funzione ha esito negativo, il valore restituito viene 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 contesto 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 liberi le singole risorse con la funzione WinSNMP corrispondente alla risorsa. Ad esempio, le applicazioni devono chiamare la funzione SnmpFreeContext per rilasciare le risorse allocate da una chiamata alla funzione SnmpStrToContext . 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
| 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 |