Funzione SnmpClose (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 SnmpClose consente all'implementazione di Microsoft WinSNMP di deallocare memoria, risorse e strutture di dati associate a una sessione WinSNMP. La funzione SnmpClose WinSNMP chiude anche i meccanismi di comunicazione aperti come risultato di una chiamata alla funzione SnmpCreateSession .
Sintassi
SNMPAPI_STATUS SNMPAPI_CALL SnmpClose(
[in] HSNMP_SESSION session
);
Parametri
[in] session
Gestire la sessione WinSNMP da chiudere.
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 sessione non è valido. |
|
Si è verificato un errore sconosciuto o non definito. |
Commenti
È consigliabile che un'applicazione WinSNMP chiami la funzione SnmpClose una volta per ogni sessione aperta dall'applicazione usando la funzione SnmpCreateSession . Se un'applicazione WinSNMP termina in modo imprevisto, deve chiamare SnmpCleanup prima che venga terminata per abilitare l'implementazione per deallocare tutte le risorse. L'implementazione elabora una chiamata SnmpCleanup come se fosse una serie di chiamate SnmpClose , una chiamata per ogni sessione aperta come risultato di una chiamata a SnmpCreateSession.
Quando l'implementazione chiude una sessione, ignora tutte le richieste asincrone in ingresso e in uscita in uscita e le risposte per la sessione. Per altre informazioni, vedere Sessioni 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 |