Funzione SnmpCleanup (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 SnmpCleanup informa l'implementazione di Microsoft WinSNMP che l'applicazione WinSNMP chiamante non richiede più i servizi dell'implementazione.
Sintassi
SNMPAPI_STATUS SNMPAPI_CALL SnmpCleanup();
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene SNMPAPI_SUCCESS. Finché l'applicazione WinSNMP non richiama correttamente la funzione SnmpStartup , qualsiasi altra chiamata a una funzione WinSNMP restituisce SNMPAPI_FAILURE, con un codice di errore esteso di SNMPAPI_NOT_INITIALIZED.
Se la funzione ha esito negativo, il valore restituito è SNMPAPI_FAILURE, ma l'applicazione WinSNMP non deve ripetere la chiamata a SnmpCleanup. 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. |
|
Si è verificato un errore sconosciuto o non definito. |
Commenti
Prima che l'applicazione WinSNMP chiami SnmpCleanup, deve chiamare la funzione SnmpClose una volta per ogni sessione che l'implementazione viene aperta in seguito a una chiamata alla funzione SnmpCreateSession .
Quando un'applicazione WinSNMP chiama la funzione SnmpCleanup , l'implementazione dealloca tutte le risorse allocate all'applicazione. È tuttavia consigliabile che un'applicazione WinSNMP liberi le risorse specifiche allocate dall'implementazione con la funzione WinSNMP corrispondente alla risorsa. Per altre informazioni sulla liberazione di singole risorse, vedere SnmpFreeEntity, SnmpFreeVbl, SnmpFreeDescriptor, SnmpFreeContext e SnmpFreePdu.
Se un'applicazione WinSNMP deve eseguire un'uscita di emergenza e chiama SnmpCleanup senza liberare singole risorse e senza chiamare SnmpClose per ogni sessione aperta, l'implementazione dealloca tutte le risorse allocate all'applicazione WinSNMP. Tuttavia, per abilitare questa funzionalità nell'implementazione, l'applicazione deve comunque chiamare SnmpCleanup.
SnmpCleanup non deve essere chiamato quando la DLL dell'applicazione è in fase di scaricamento.
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 |