Funzione SnmpMgrTrapListen (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 SnmpMgrTrapListen registra la capacità di un'applicazione di gestione SNMP di ricevere trap SNMP dal servizio Trap SNMP. Questa funzione è un elemento dell'API di gestione SNMP.
Sintassi
BOOL SNMP_FUNC_TYPE SnmpMgrTrapListen(
[out] HANDLE *phTrapAvailable
);
Parametri
[out] phTrapAvailable
Puntatore a un handle di evento per ricevere un'indicazione che sono disponibili trap e che l'applicazione deve chiamare la funzione SnmpMgrGetTrap .
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni sull'errore estese, chiamare GetLastError, che può restituire uno dei codici di errore seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Indica un errore di allocazione della memoria. |
|
Indica che questa funzione è già stata chiamata. |
|
Indica che si sono verificati uno o più errori; le trappole non sono accessibili. L'applicazione può tentare di chiamare di nuovo la funzione. |
Questa funzione può restituire anche altri errori di sistema.
Commenti
È importante notare che per gli utenti che non sono amministratori, la funzione SnmpMgrTrapListen ha esito positivo solo se il servizio trap SNMP è stato avviato.
L'applicazione deve sempre chiamare la funzione SnmpMgrTrapListen prima di chiamare la funzione SnmpMgrGetTrap . Ciò è dovuto al fatto che l'handle eventi a cui punta il parametro phTrapAvailable consente l'acquisizione basata su eventi di trap SNMP. L'API di gestione SNMP segnala l'evento di un'applicazione quando il servizio Trap SNMP fornisce una trap.
L'applicazione può anche eseguire il polling della funzione SnmpMgrGetTrap per individuare le trap a intervalli regolari. In questo caso, l'applicazione deve chiamare ripetutamente SnmpMgrGetTrap fino a quando la funzione non restituisce zero.
Windows Server 2003: Le applicazioni di gestione SNMP possono chiamare SnmpMgrClose con un parametro di sessioneNULL per pulire le risorse associate a una chiamata corretta alla funzione SnmpMgrTrapListen. Si noti, tuttavia, che se l'applicazione è una DLL, non deve chiamare SnmpMgrClose dalla relativa funzione del punto di ingresso DllMain .
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)