Funzione SnmpCleanup (winsnmp.h)

Articolo
08/27/2023

[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.

Nota Un'applicazione WinSNMP deve chiamare la funzione SnmpCleanup come ultima funzione WinSNMP prima che termini.

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
SNMPAPI_NOT_INITIALIZED	La funzione SnmpStartup non è stata completata correttamente.
SNMPAPI_ALLOC_ERROR	Errore durante l'allocazione della memoria.
SNMPAPI_OTHER_ERROR	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