Funzione SnmpMgrGetTrap (mgmtapi.h)

Articolo
02/29/2024

[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 SnmpMgrGetTrap restituisce dati di trap in sospeso che il chiamante non ha ricevuto se la ricezione trap è abilitata. Questa funzione è un elemento dell'API di gestione SNMP.

Oltre alle informazioni restituite da questa funzione, la funzione SnmpMgrGetTrapEx restituisce l'indirizzo dell'origine del trasporto e la stringa della community della trap.

Sintassi

BOOL SNMP_FUNC_TYPE SnmpMgrGetTrap(
  [out] AsnObjectIdentifier *enterprise,
  [out] AsnNetworkAddress   *IPAddress,
  [out] AsnInteger          *genericTrap,
  [out] AsnInteger          *specificTrap,
  [out] AsnTimeticks        *timeStamp,
  [out] RFC1157VarBindList  *variableBindings
);

Parametri

[out] enterprise

Puntatore a una struttura AsnObjectIdentifier per ricevere l'organizzazione che ha generato la trap SNMP.

[out] IPAddress

Puntatore a una variabile per ricevere l'indirizzo dell'agente che ha generato la trap SNMP.

[out] genericTrap

Puntatore a una variabile per ricevere un indicatore della trappola generica. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
SNMP_GENERICTRAP_COLDSTART	L'agente inizializza le entità del protocollo nella modalità gestita. Può modificare gli oggetti nella relativa visualizzazione.
SNMP_GENERICTRAP_WARMSTART	L'agente sta reinizializzando se stesso, ma non altererà gli oggetti nella relativa visualizzazione.
SNMP_GENERICTRAP_LINKDOWN	Un'interfaccia associata è stata modificata dallo stato "su" allo stato "down". La prima variabile nell'elenco associazioni di variabili identifica l'interfaccia.
SNMP_GENERICTRAP_LINKUP	Un'interfaccia associata è stata modificata dallo stato "giù" allo stato "su". La prima variabile nell'elenco associazioni di variabili identifica l'interfaccia.
SNMP_GENERICTRAP_AUTHFAILURE	Un'entità SNMP ha inviato un messaggio SNMP, ma ha falsemente affermato di appartenere a una community nota.
SNMP_GENERICTRAP_EGPNEIGHLOSS	Un peer EGP è stato modificato nello stato "down". La prima variabile nell'elenco associazioni di variabili identifica l'indirizzo IP del peer EGP.
SNMP_GENERICTRAP_ENTERSPECIFIC	Si è verificato un evento straordinario e viene identificato nel parametro specificoTrap con un valore specifico dell'organizzazione.

[out] specificTrap

Puntatore a una variabile per ricevere un'indicazione della trappola specifica generata.

[out] timeStamp

Puntatore a una variabile per ricevere il timestamp.

[out] variableBindings

Puntatore a una struttura SnmpVarBindList per ricevere l'elenco di associazioni di variabili.

Valore restituito

Se la funzione restituisce una trap, il valore restituito è TRUE. Il codice per l'errore può essere recuperato chiamando SnmpGetLastError immediatamente dopo la chiamata.

È consigliabile chiamare ripetutamente la funzione SnmpMgrGetTrap finché non restituisce FALSE (zero). La funzione può anche restituire i codici di errore seguenti.

Codice restituito	Descrizione
SNMP_MGMTAPI_TRAP_ERRORS	Indica che sono stati rilevati errori; le trap non sono accessibili.
SNMP_MGMTAPI_NOTRAPS	Indica che non sono disponibili trap.
SNMP_MEM_ALLOC_ERROR	Indica un errore di allocazione della memoria.

Commenti

L'applicazione deve sempre chiamare la funzione SnmpMgrTrapListen prima di chiamare la funzione SnmpMgrGetTrap . Ciò avviene perché l'handle eventi a cui fa riferimento il parametro phTrapAvailable della funzione SnmpMgrTrapListen 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 genera una trappola.

L'applicazione può anche eseguire il polling della funzione SnmpMgrGetTrap per le trap a intervalli regolari. In questo caso, l'applicazione deve chiamare ripetutamente SnmpMgrGetTrap fino a quando la funzione restituisce zero.

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

AsnObjectIdentifier

Funzioni SNMP

Panoramica del protocollo Simple Network Management Protocol (SNMP)

SnmpMgrTrapListen

SnmpVarBindList

Condividi tramite