Funzione SnmpListen (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 SnmpListen WinSNMP registra un'applicazione WinSNMP come agente SNMP. Un'applicazione agente chiama questa funzione per informare l'implementazione di Microsoft WinSNMP che un'entità funzionerà nel ruolo di un agente SNMP. Un'applicazione chiama anche questa funzione per informare l'implementazione quando un'entità non funzionerà più in questo ruolo. La funzione SnmpListen è un elemento dell'API WinSNMP, versione 2.0.
Sintassi
SNMPAPI_STATUS SNMPAPI_CALL SnmpListen(
[in] HSNMP_ENTITY hEntity,
[in] SNMPAPI_STATUS lStatus
);
Parametri
[in] hEntity
Gestire l'entità WinSNMP per notificare quando l'implementazione di Microsoft WinSNMP riceve un messaggio di richiesta SNMP in ingresso ( PDU). Questo parametro identifica l'applicazione agente. Per altre informazioni, vedere le sezioni Note e Valori restituiti seguenti.
Quando si chiama la funzione SnmpCreateSession , è possibile specificare se l'implementazione deve usare un messaggio di notifica della finestra o una funzione SNMPAPI_CALLBACK per notificare all'applicazione quando è disponibile un messaggio SNMP o un evento asincrono.
[in] lStatus
Specifica una variabile integer long senza segno che indica se l'entità WinSNMP identificata dal parametro hEntity agisce in un ruolo dell'agente SNMP o se non agisce più in questo ruolo. Questo parametro può avere uno dei valori seguenti.
| Valore | Significato |
|---|---|
|
L'entità WinSNMP specificata funziona in un ruolo agente. |
|
L'entità WinSNMP specificata non funziona in un ruolo dell'agente. |
Passando un valore di SNMPAPI_OFF rilascia entrambe le risorse allocate all'entità e la porta assegnata. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.
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. 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 hEntity non è valido. Questo parametro deve essere un handle restituito da una chiamata precedente alla funzione SnmpStrToEntity . |
|
Il parametro lStatus non è valido. |
|
L'entità specificata dal parametro hEntity è già funzionante nel ruolo di un agente SNMP. |
|
Si verifica un errore del livello di trasporto di rete. Impossibile creare un socket per l'entità specificata dal parametro hEntity . |
|
Si è verificato un errore nel livello di trasporto di rete durante il tentativo di associare un socket per l'entità specificata dal parametro hEntity . |
|
Si è verificato un errore sconosciuto o non definito. |
Commenti
Quando si specifica un'entità, specificare in modo esplicito la famiglia di indirizzi, l'indirizzo dell'interfaccia e la porta per l'entità. Questo perché WinSNMP assegna questi attributi a ogni entità WinSNMP come risultato di una chiamata alla funzione SnmpStrToEntity . L'implementazione usa le impostazioni di indirizzo e porta attualmente assegnate all'entità specificata dal parametro hEntity quando invia notifiche all'applicazione agente. Per altre informazioni, vedere SnmpSetPort.
Quando si chiama la funzione SnmpClose per una sessione WinSNMP e la funzione SnmpCleanup per un'applicazione WinSNMP, è necessario rilasciare tutte le porte associate alle applicazioni agente WinSNMP.
Per altre informazioni sulle applicazioni di gestione SNMP e sulle applicazioni agente, vedere Registrazione di un'applicazioneagente SNMP e Informazioni su SNMP.
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 |