Condividi tramite

Funzioni WinSNMP

  • Articolo

[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.

Le funzioni usate con WinSNMP rientrano nei raggruppamenti funzionali seguenti. Segue un elenco alfabetico.

Funzioni di comunicazione WinSNMP

Le funzioni di comunicazione WinSNMP forniscono un'interfaccia tra l'applicazione WinSNMP chiamante e l'implementazione di Microsoft WinSNMP. L'implementazione gestisce la comunicazione tra l'applicazione e altre entità di gestione.

Funzione Descrizione
SnmpCancelMsg Richiede che l'implementazione di Microsoft WinSNMP annulla i tentativi di ritrasmissione e le notifiche di timeout per un messaggio di richiesta SNMP.
SnmpCleanup Informa l'implementazione che un'applicazione sta disconnettendo e non richiede più risorse allocate.
SnmpCleanupEx Esegue la pulizia quando non sono presenti chiamate con esito positivo a SnmpStartup o SnmpStartupEx all'interno di un'applicazione WinSNMP.
SnmpClose Consente all'implementazione di deallocare le risorse associate a una sessione e di chiudere i meccanismi di comunicazione.
SnmpCreateSession Richiede l'implementazione per aprire una sessione WinSNMP e allocare risorse e meccanismi di comunicazione. Quando si sviluppano nuove applicazioni WinSNMP, è consigliabile chiamare la funzione SnmpCreateSession per aprire una sessione WinSNMP anziché chiamare la funzione SnmpOpen .
SnmpListen Registra o annulla la registrazione di un'applicazione WinSNMP come agente SNMP.
SnmpOpen Richiede l'implementazione per aprire una sessione WinSNMP e allocare risorse e meccanismi di comunicazione. Quando si sviluppano nuove applicazioni WinSNMP, è consigliabile chiamare la funzione SnmpCreateSession per aprire una sessione WinSNMP anziché chiamare la funzione SnmpOpen .
SnmpRecvMsg Restituisce i messaggi SNMP e i dati e le notifiche di trap in sospeso.
SnmpRegister Informa l'implementazione che l'applicazione deve registrare o annullare la registrazione per le trap e le notifiche.
SnmpSendMsg Richiede che l'implementazione trasmette un'unità dati del protocollo.
SnmpStartup Notifica all'implementazione di eseguire le procedure di inizializzazione per l'applicazione. Un'applicazione deve chiamare correttamente la funzione SnmpStartup prima di chiamare qualsiasi altra funzione WinSNMP.
SnmpStartupEx Notifica all'implementazione di Microsoft WinSNMP che l'applicazione WinSNMP richiede i servizi dell'implementazione. SnmpStartupEx abilita il supporto per più moduli software indipendenti che usano WinSNMP all'interno della stessa applicazione.
SNMPAPI_CALLBACK Notifica a una sessione WinSNMP che è disponibile un messaggio SNMP o un evento asincrono. Nota: Questa funzione di callback si applica solo alle sessioni aperte come risultato di una chiamata alla funzione SnmpCreateSession .

Funzioni di entità e contesto WinSNMP

Le funzioni di entità e contesto WinSNMP consentono a un'applicazione WinSNMP di specificare nomi descrittivi per entità e contesti SNMP. L'implementazione di Microsoft WinSNMP converte il nome nei relativi componenti SNMPv1 o SNMPv2C usando il database dell'implementazione.

Funzione Descrizione
SnmpContextToStr Restituisce una stringa che identifica un contesto SNMP (un set di risorse dell'oggetto gestito).
SnmpEntityToStr Restituisce una stringa che identifica un'entità di gestione SNMP.
SnmpFreeContext Rilascia le risorse allocate dalla funzione SnmpStrToContext per un contesto SNMP.
SnmpFreeEntity Rilascia le risorse allocate dalla funzione SnmpStrToEntity per un'entità di gestione SNMP.
SnmpSetPort Modifica la porta assegnata a un'entità di destinazione SNMP.
SnmpStrToContext Restituisce un handle alle informazioni sul contesto SNMP specifiche dell'implementazione.
SnmpStrToEntity Restituisce un handle alle informazioni sull'entità di gestione SNMP specifiche dell'implementazione.

Funzioni di database WinSNMP

Le funzioni di database WinSNMP forniscono un'applicazione WinSNMP con accesso alle impostazioni correnti nell'archivio di informazioni amministrative dell'implementazione di Microsoft WinSNMP. Queste funzioni consentono di modificare la modalità di ritrasmissione e la modalità di traduzione dell'entità e del contesto. Le funzioni di database forniscono anche all'applicazione la possibilità di modificare i valori di timeout e conteggio dei tentativi.

Funzione Descrizione
SnmpGetRetransmitMode Restituisce l'impostazione corrente della modalità di ritrasmissione.
SnmpGetRetry Restituisce il valore del conteggio dei tentativi, in unità, per la ritrasmissione delle richieste dei messaggi SNMP.
SnmpGetTimeout Restituisce il valore di timeout, in centesimi di secondo, per la trasmissione di richieste di messaggio SNMP.
SnmpGetTranslateMode Restituisce l'impostazione corrente della modalità di conversione dell'entità e del contesto.
SnmpGetVendorInfo Recupera informazioni che identificano il fornitore WinSNMP.
SnmpSetRetransmitMode Modifica la modalità di ritrasmissione.
SnmpSetRetry Modifica il valore del conteggio dei tentativi per la ritrasmissione delle richieste di messaggio SNMP.
SnmpSetTimeout Modifica il valore di timeout per la trasmissione di richieste di messaggio SNMP.
SnmpSetTranslateMode Modifica la modalità di traduzione dell'entità e del contesto.

Funzioni PDU WinSNMP

Le funzioni PDU WinSNMP consentono alle applicazioni WinSNMP di estrarre e aggiornare gli elementi di dati (o campi) di un PDU. Sono incluse le CPU restituite da una chiamata alla funzione SnmpRecvMsg o alla funzione SnmpDecodeMsg . Le funzioni PDU costruiscono anche CPU per l'uso nelle funzioni SnmpSendMsg e SnmpEncodeMsg .

Funzione Descrizione
SnmpCreatePdu Crea e inizializza un'unità dati del protocollo SNMP.
SnmpDuplicatePdudu Duplica un'unità dati del protocollo SNMP.
SnmpFreePdu Rilascia risorse associate a un'unità dati del protocollo SNMP creata dalla funzione SnmpCreatePdu o snmpDuplicatePdu.
SnmpGetPduData Restituisce elementi dati selezionati da un'unità dati del protocollo SNMP specificata.
SnmpSetPduData Aggiornamenti elementi dati selezionati in un'unità dati del protocollo SNMP specificata.

Funzioni di utilità WinSNMP

Le funzioni di utilità WinSNMP consentono a un'applicazione WinSNMP di gestire oggetti e messaggi SNMP nell'interfaccia WinSNMP.

Funzione Descrizione
SnmpDecodeMsg Decodifica un messaggio SNMP codificato o serializzato nei relativi componenti costitutivi.
SnmpEncodeMsg Crea un messaggio SNMP codificato.
SnmpFreeDescriptor Segnala l'implementazione di Microsoft WinSNMP che deve liberare la memoria allocata per un descrittore specifico.
SnmpGetLastError Restituisce il valore del codice dell'ultimo errore per l'ultima operazione SNMP.
SnmpOidCompare Confronta due identificatori di oggetto SNMP.
SnmpOidCopy Copia un identificatore di oggetto SNMP.
SnmpOidToStr Converte la rappresentazione binaria interna di un identificatore di oggetto SNMP nel formato stringa numerica punteggiata.
SnmpStrToOid Converte il formato di stringa numerica punteggiata di un identificatore di oggetto SNMP nella relativa rappresentazione binaria interna.

Funzioni di associazione di variabili WinSNMP

Le funzioni di associazione di variabili WinSNMP consentono alle applicazioni WinSNMP di costruire e modificare gli elenchi di binding delle variabili e di includerli in CPU.

Funzione Descrizione
SnmpCountVbl Enumera le voci di associazione di variabili in un elenco di associazione di variabili specificato.
SnmpCreateVbl Crea un nuovo elenco di associazioni di variabili.
SnmpDeleteVb Rimuove una voce di associazione di variabili da un elenco di associazioni di variabili.
SnmpDuplicateVbl Copia un elenco di associazioni di variabili.
SnmpFreeVbl Rilascia le risorse per un elenco di associazioni di variabili allocato in precedenza dalla funzione SnmpCreateVbl o snmpDuplicateVbl .
SnmpGetVb Recupera informazioni da una voce di associazione di variabili specificata.
SnmpSetVb Modifica le voci di associazione di variabili in un elenco di associazioni di variabili; aggiunge nuove voci di associazione di variabili a un elenco di associazioni di variabili esistente.

Elenco alfabetico delle funzioni WinSNMP