Impostazione della modalità di conversione di entità e contesto
L'applicazione WinSNMP può specificare l'interpretazione e la conversione dei parametri di entità e contesto impostando l'entità e la modalità di conversione del contesto. L'implementazione di Microsoft WinSNMP archivia la modalità in un database.
L'impostazione della modalità di traduzione dell'entità e del contesto determina il modo in cui la funzione SnmpStrToEntity e la funzione SnmpStrToContext interpretano le stringhe di input. L'impostazione determina anche il tipo di stringa di output restituita dalle funzioni SnmpEntityToStr e snmpContextToStr. Per altre informazioni, vedere supporto per le stringhe di indirizzi IPX in WinSNMP.
L'implementazione restituisc e l'entità predefinita corrente e la modalità di conversione del contesto nel parametro nTranslateMode del funzione SnmpStartup. Per recuperare l'entità corrente e la modalità di conversione del contesto in vigore per l'implementazione, un'applicazione può chiamare la funzione SnmpGetTranslateMode in qualsiasi momento.
Seguono le modalità di traduzione valide per l'entità e il contesto.
| Modalità | Significato |
|---|---|
| SNMPAPI_TRADOTTO | L'implementazione usa il suo database per tradurre nomi intuitivi per le entità SNMP e gli oggetti gestiti. L'implementazione li converte nei componenti SNMPv1 o SNMPv2C. |
| SNMPAPI_UNTRANSLATED_V1 | L'implementazione interpreta i parametri dell'entità SNMP come indirizzi di trasporto SNMP letterali e parametri di contesto come stringhe della community SNMP letterali. Per le entità di destinazione SNMPv2, l'implementazione crea messaggi SNMP in uscita che contengono un valore pari a zero nel campo della versione. |
| SNMPAPI_UNTRANSLATED_V2 | L'implementazione interpreta i parametri dell'entità SNMP come indirizzi di trasporto SNMP e i parametri di contesto come stringhe della community SNMP letterali. Per le entità di destinazione SNMPv2, l'implementazione crea messaggi SNMP in uscita che contengono un valore pari a 1 nel campo della versione. |
L'implementazione tenta di associare le risorse nel database all'indirizzo di trasporto letterale dell'entità di gestione.
Per modificare l'entità e la modalità di conversione del contesto, un'applicazione WinSNMP deve chiamare la funzione SnmpSetTranslateMode. Se la modalità di conversione richiesta non è valida, la funzione non riesce e SnmpGetLastError restituisce il codice di errore SNMPAPI_MODE_INVALID.