Funzione SnmpMgrClose (mgmtapi.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 SnmpMgrClose chiude i socket di comunicazione e le strutture di dati associate alla sessione specificata. Questa funzione è un elemento dell'API di gestione SNMP.
Sintassi
BOOL SNMP_FUNC_TYPE SnmpMgrClose(
[in] LPSNMP_MGR_SESSION session
);
Parametri
[in] session
Puntatore a una struttura interna che specifica la sessione da chiudere. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero.
Questa funzione può restituire codici di errore di Windows Sockets.
Commenti
Windows Server 2003: Le applicazioni di gestione SNMP possono chiamare SnmpMgrClose con un parametro di sessioneNULL per pulire le risorse associate a una chiamata riuscita alla funzione SnmpMgrTrapListen. Si noti, tuttavia, che se l'applicazione è una DLL, non deve chiamare SnmpMgrClose dalla relativa funzione del punto di ingresso DllMain .
SnmpMgrClose non deve essere chiamato quando la DLL dell'applicazione è in fase di scaricamento.
Windows Server 2003: SnmpMgrClose richiede più tempo per l'esecuzione in Windows Server 2003 rispetto a una chiamata identica in Windows 2000. In particolare, una chiamata a questa API richiede fino a un secondo per l'esecuzione in Windows Server 2003, mentre la stessa chiamata richiede circa 3 millisecondi in Windows 2000. ciò può causare problemi di prestazioni per le applicazioni SNMP di Windows Server 2003 che chiamano SnmpMgrOpen e SnmpMgrClose di frequente.
Per risolvere questo problema, creare una sessione di gestione SNMP aggiuntiva chiamando SnmpMgrOpen sull'host locale durante l'avvio dell'applicazione e mantenerla aperta per la durata della durata dell'applicazione. La chiusura del gestore sessione chiuderà tutte le sessioni associate, richiedendo una sola chiamata a SnmpMgrClose.
Windows Server 2003 con SP1: Il problema precedente non si applica a Windows 2003 Service Pack 1.
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 | mgmtapi.h |
| Libreria | Mgmtapi.lib |
| DLL | Mgmtapi.dll |
Vedi anche
Panoramica del protocollo Simple Network Management Protocol (SNMP)