Funzioni SNMP
[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.
Questo argomento descrive tre raggruppamenti di funzioni SNMP ed elenca le funzioni incluse in ogni gruppo:
- Funzioni API dell'agente di estensione SNMP
- Funzioni API di gestione SNMP
- Funzioni API dell'utilità SNMP
Funzioni API dell'agente di estensione SNMP
Le funzioni dell'agente di estensione SNMP definiscono l'interfaccia tra il servizio SNMP e le DLL dell'agente di estensione SNMP di terze parti. Nella tabella seguente sono elencate le funzioni che le applicazioni possono usare per risolvere le associazioni di variabili specificate dalle unità dati del protocollo SNMP (PDU) in ingresso.
| Funzione API dell'agente di estensione SNMP | Descrizione |
|---|---|
| SnmpExtensionClose | Richiede che l'agente di estensione SNMP dealloca le risorse e termini le operazioni. |
| SnmpExtensionInit | Inizializza la DLL dell'agente di estensione SNMP. |
| SnmpExtensionInitEx | Identifica eventuali sottoalberi MIB (Management Information Base) aggiuntivi supportati dall'agente di estensione SNMP. |
| SnmpExtensionMonitor | Fornisce all'agente di estensione SNMP informazioni sui contatori interni e sui parametri del servizio. |
| SnmpExtensionQuery | Risolve le richieste SNMP che contengono variabili in uno o più sottoalberi MIB registrati dell'agente di estensione SNMP. |
| SnmpExtensionQueryEx | Elabora le richieste SNMP che specificano le variabili in uno o più sottoalberi MIB registrati dagli agenti di estensione SNMP. |
| SnmpExtensionTrap | Recupera le informazioni richieste dal servizio per generare trap per l'agente di estensione SNMP. |
Funzioni API di gestione SNMP
Le funzioni di gestione SNMP definiscono l'interfaccia tra le applicazioni di gestione SNMP di terze parti e la funzione di gestione Mgmtapi.dll DLL (Dynamic Link Library). La DLL funziona insieme al servizio trap SNMP (Snmptrap.exe) e può interagire con una o più applicazioni di gestione SNMP di terze parti. Nella tabella seguente sono elencate le funzioni di gestione usate dalle applicazioni di gestione di terze parti per eseguire operazioni di gestione SNMP.
| Funzione API di gestione SNMP | Descrizione |
|---|---|
| SnmpMgrClose | Chiude i socket di comunicazione e le strutture di dati associate alla sessione specificata. |
| SnmpMgrCtl | Imposta un parametro operativo associato a una sessione SNMP. |
| SnmpMgrGetTrap | Restituisce dati trap in sospeso che il chiamante non ha ricevuto se è abilitata la ricezione trap. |
| SnmpMgrGetTrapEx | Restituisce dati trap in sospeso che il chiamante non ha ricevuto se è abilitata la ricezione trap. Restituisce anche l'indirizzo dell'origine del trasporto e la trappola della comunità associata alla trappola. |
| SnmpMgrOidToStr | Converte una struttura dell'identificatore di oggetto interno nella relativa rappresentazione di stringa. |
| SnmpMgrOpen | Inizializza i socket di comunicazione e le strutture di dati necessari per stabilire la comunicazione con l'agente SNMP. |
| SnmpMgrRequest | Richiede che l'operazione specificata venga eseguita dall'agente specificato. |
| SnmpMgrStrToOid | Converte il formato stringa di un identificatore di oggetto nella struttura dell'identificatore di oggetto interno. |
| SnmpMgrTrapListen | Registra la capacità di un'applicazione di gestione SNMP di ricevere trap SNMP dal servizio Trap SNMP. |
Funzioni API dell'utilità SNMP
Le funzioni di utilità SNMP forniscono funzionalità utili durante lo sviluppo di applicazioni SNMP, inclusa la semplificazione della manipolazione delle strutture di dati SNMP. Nella tabella seguente sono elencate le funzioni dell'utilità SNMP.
| Funzione API dell'utilità SNMP | Descrizione |
|---|---|
| SnmpSvcGetUptime | Recupera il tempo, espresso in centisecondi, per il quale è in esecuzione il servizio SNMP. |
| SnmpSvcSetLogLevel | Regola il livello di dettaglio dell'output di debug dal servizio SNMP e dagli agenti di estensione SNMP. |
| SnmpSvcSetLogType | Regola la destinazione per l'output di debug dal servizio SNMP e dagli agenti di estensione SNMP. |
| SnmpUtilAsnAnyCpy | Copia una struttura AsnAny di origine in una struttura AsnAny di destinazione. |
| SnmpUtilAsnAnyFree | Libera la memoria allocata per una struttura AsnAny specificata. |
| SnmpUtilDbgPrint | Imposta il livello di informazioni di debug da ricevere dal servizio SNMP o da una chiamata a SnmpUtilDbgPrint. |
| SnmpUtilIdsToA | Converte un identificatore di oggetto (OID) in una stringa con terminazione Null. |
| SnmpUtilMemAlloc | Alloca la memoria dinamica dall'heap del processo. |
| SnmpUtilMemFree | Libera l'oggetto memoria specificato. |
| SnmpUtilMemReAlloc | Modifica le dimensioni dell'oggetto memoria specificato. |
| SnmpUtilOctetsCmp | Confronta due stringhe ottetto. |
| SnmpUtilOctetsCpy | Copia una struttura AsnOctetString di origine in una struttura AsnOctetString di destinazione. |
| SnmpUtilOctetsFree | Libera la memoria allocata per la stringa di ottetto specificata. |
| SnmpUtilOctetsNCmp | Esegue un confronto di due stringhe ottetto con il numero specificato di subidentifier. |
| SnmpUtilOidAppend | Aggiunge un identificatore di oggetto di origine, contenuto in una struttura AsnObjectIdentifier , a un identificatore di oggetto di destinazione. |
| SnmpUtilOidCmp | Confronta due identificatori di oggetto contenuti nelle strutture AsnObjectIdentifier . |
| SnmpUtilOidCpy | Copia una struttura AsnObjectIdentifier di origine in una struttura AsnObjectIdentifier di destinazione. |
| SnmpUtilOidFree | Libera la memoria allocata per l'identificatore di oggetto specificato. |
| SnmpUtilOidNCmp | Confronta due identificatori di oggetto contenuti nelle strutture AsnObjectIdentifier con il numero specificato di subidentifier. |
| SnmpUtilOidToA | Converte un identificatore di oggetto (OID) in una stringa con terminazione Null. |
| SnmpUtilPrintAsnAny | Stampa un valore contenuto in una struttura AsnAny per scopi di debug e sviluppo. |
| SnmpUtilPrintOid | Formatta l'identificatore di oggetto (OID) specificato e stampa il risultato nel dispositivo di output standard. |
| SnmpUtilVarBindCpy | Copia una struttura SnmpVarBind di origine in una struttura SnmpVarBind di destinazione. |
| SnmpUtilVarBindListCpy | Copia una struttura SnmpVarBindList di origine in una struttura SnmpVarBindList di destinazione. |
| SnmpUtilVarBindFree | Libera la memoria allocata per la struttura SnmpVarBind specificata. |
| SnmpUtilVarBindListFree | Libera la memoria allocata per la struttura SnmpVarBindList specificata. |