Registrazioni multiple trap

Quando un'applicazione WinSNMP registra una sessione WinSNMP per trap o notifiche, sono disponibili diverse opzioni. Per questo motivo, un'applicazione può chiamare la funzionesnmpRegisterpiù volte, definendo un filtro personalizzato per la ricezione di trap e notifiche. Ad esempio, è possibile registrarsi per un tipo di trap o notifica o per tutte le trap e le notifiche, a seconda del valore del parametro notifica. Inoltre, l'applicazione può specificare valori in altri parametri per la funzione SnmpRegister per definire ulteriormente le trap e le notifiche che devono raggiungere un'applicazione. Per altre informazioni, vedere Gestione di trap e notifiche.

Di seguito sono riportate le istanze in cui più chiamate a snmpRegister sono ridondanti. In questi casi SnmpRegister restituisce SNMPAPI_SUCCESS se la funzione viene completata correttamente, ma la registrazione ridondante è inefficace.

1. Una chiamata al SnmpRegister funzione che richiede il recapito filtrato di trap e notifiche alla sessione, dopo una precedente chiamata a SnmpRegister richiedere il recapito di tutte le trap e le notifiche (recapito non filtrato). Questa chiamata è ridondante perché la sessione riceve già tutte le trap e le notifiche, incluso il singolo tipo definito dal filtro.
2. Una chiamata duplicata a SnmpRegistero una in cui l'elenco di parametri è identico all'elenco di parametri in una chiamata precedente a snmpRegister per la sessione.
3. Chiamata alla funzione snmpRegisterche richiede il recapito filtrato di trap e notifiche in base a un identificatore di oggetto (OID) il cui prefisso è un OID specificato in una chiamata precedente a SnmpRegister. Ad esempio, è possibile specificare "1.3.6.1.4.1.311" nel parametro notifica per ricevere notifiche provenienti da qualsiasi entità agente MICROSOFT SNMP. Se si chiama di nuovo SnmpRegister e si specifica "1.3.6.1.4.1.311.1", la seconda chiamata è ridondante perché la sessione riceve già tutte le trap e le notifiche che contengono il prefisso OID "1.3.6.1.4.1.311".

Per annullare la registrazione della sessione, è necessario associare ogni chiamata di registrazione univoca alla funzionesnmpRegister. Chiamare snmpRegister per annullare la registrazione della sessione e assicurarsi che i primi cinque parametri per SnmpRegister siano identici a quelli nella chiamata di registrazione iniziale. L'unica differenza tra la chiamata iniziale e la chiamata di annullamento della registrazione è che durante la registrazione è necessario specificare il valore SNMPAPI_ON nel parametro stato e quando si chiama la funzione per annullare la registrazione, è necessario specificare SNMPAPI_OFF. Non è necessario associare le chiamate di registrazione ridondanti alla funzione snmpRegister. È necessaria solo la prima chiamata di registrazione univoca.

Per modificare i criteri di filtro, potrebbe essere necessario annullare la registrazione di un'applicazione e disabilitare il recapito di determinate trap o notifiche. L'applicazione può quindi creare un nuovo filtro chiamando SnmpRegister, passando i valori appropriati.