Funzioni WinSNMP
[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
- funzioni di entità e contesto
- Funzioni di database
- funzioni PDU
- funzioni di utilità
- funzioni di associazione di variabili
- elenco alfabetico delle funzioni WinSNMP
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
- SNMPAPI_CALLBACK
- SnmpCancelMsg
- SnmpCleanup
- SnmpClose
- SnmpContextToStr
- SnmpCountVbl
- snmpCreatePdu
- snmpCreateSession
- snmpCreateVbl
- snmpDecodeMsg
- SnmpDeleteVb
- SnmpDuplicatePdu
- snmpDuplicateVbl
- SnmpEncodeMsg
- SnmpEntityToStr
- snmpFreeContext
- snmpFreeDescriptor
- snmpFreeEntity
- snmpFreePdu
- SnmpFreeVbl
- SnmpGetLastError
- snmpGetPduData
- SnmpGetRetransmitMode
- SnmpGetRetry
- SnmpGetTimeout
- SnmpGetTranslateMode
- SnmpGetVb
- SnmpGetVendorInfo
- snmpListen
- SnmpOidCompare
- SnmpOidCopy
- SnmpOidToStr
- SnmpOpen
- SnmpRecvMsg
- snmpRegister
- SnmpSendMsg
- SnmpSetPduData
- snmpSetPort
- snmpSetRetransmitMode
- snmpSetRetry
- SnmpSetTimeout
- SnmpSetTranslateMode
- SnmpSetVb
- snmpStartup
- SnmpStrToContext
- snmpStrToEntity
- SnmpStrToOid