Condividi tramite

Funzioni WinSNMP

  • Articolo

[SNMP è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive. Usare invece Gestione remota Windows, ovvero l'implementazione Microsoft di WS-Man.

Le funzioni usate con WinSNMP rientrano nei raggruppamenti funzionali seguenti. Di seguito è riportato 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 per 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 funzioneSnmpCreateSessionper 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 funzionesnmpCreateSessionper aprire una sessione WinSNMP anziché chiamare la funzione snmpOpen.
SnmpRecvMsg Restituisce messaggi SNMP e dati e notifiche trap in sospeso.
snmpRegister Informa l'implementazione che l'applicazione deve registrare o annullare la registrazione per trap e notifiche.
SnmpSendMsg Richiede che l'implementazione trasmetta un'unità dati del protocollo.
snmpStartup Notifica all'implementazione di eseguire procedure di inizializzazione per l'applicazione. Un'applicazione deve chiamare correttamente la funzionesnmpStartupprima 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 in seguito a una chiamata alla funzioneSnmpCreateSession.

Funzioni di contesto e entità WinSNMP

Le funzioni di contesto e entità 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 funzionesnmpStrToEntityper un'entità di gestione SNMP.
snmpSetPort Modifica la porta assegnata a un'entità di destinazione SNMP.
SnmpStrToContext Restituisce un handle per le informazioni sul contesto SNMP specifiche dell'implementazione.
snmpStrToEntity Restituisce un handle per le informazioni sull'entità di gestione SNMP specifiche dell'implementazione.

Funzioni di database WinSNMP

Le funzioni di database WinSNMP forniscono a un'applicazione WinSNMP l'accesso alle impostazioni correnti nell'archivio delle informazioni amministrative dell'implementazione di Microsoft WinSNMP. Queste funzioni consentono di modificare la modalità di ritrasmissione e la modalità di conversione dell'entità e del contesto. Le funzioni di database forniscono inoltre 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 numero di tentativi, in unità, per la ritrasmissione delle richieste di messaggi SNMP.
SnmpGetTimeout Restituisce il valore di timeout, in centesimi di secondo, per la trasmissione delle richieste di messaggi SNMP.
SnmpGetTranslateMode Restituisce l'impostazione corrente dell'entità e della modalità di conversione 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 messaggi SNMP.
SnmpSetTimeout Modifica il valore di timeout per la trasmissione delle richieste di messaggi SNMP.
SnmpSetTranslateMode Modifica la modalità di conversione dell'entità e del contesto.

Funzioni PDU WinSNMP

Le funzioni PDU WinSNMP consentono alle applicazioni WinSNMP di estrarre e aggiornare gli elementi dati (o i campi) di un PDU. Sono incluse le PDU restituite da una chiamata alla funzione SnmpRecvMsg o alla funzione SnmpDecodeMsg. Le funzioni PDU creano anche PDU da usare nelle funzioniSnmpSendMsgSnmpSendMsg e snmpEncodeMsg.

Funzione Descrizione
snmpCreatePdu Crea e inizializza un'unità dati del protocollo SNMP.
SnmpDuplicatePdu Duplica un'unità dati del protocollo SNMP.
snmpFreePdu Rilascia le risorse associate a un'unità dati del protocollo SNMP creata dalla SnmpCreatePdu o dalla funzione SnmpDuplicatePdu.
snmpGetPduData Restituisce gli elementi dati selezionati da un'unità dati del protocollo SNMP specificata.
SnmpSetPduData Aggiorna gli elementi dati selezionati in un'unità dati del protocollo SNMP specificata.

Funzioni dell'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 componenti costitutivi.
SnmpEncodeMsg Crea un messaggio SNMP codificato.
snmpFreeDescriptor Segnala all'implementazione Di Microsoft WinSNMP che deve liberare la memoria allocata per un descrittore specifico.
SnmpGetLastError Restituisce l'ultimo valore del codice di 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 di 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 elenchi di associazioni di variabili e includerli in PDU.

Funzione Descrizione
SnmpCountVbl Enumera le voci di associazione di variabili in un elenco di associazioni 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 dalSnmpCreateVblo dalla funzioneSnmpDuplicateVbl.
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