Impostazione della modalità di conversione dell'entità e del contesto

L'applicazione WinSNMP può specificare l'interpretazione e la traduzione dei parametri di entità e contesto impostando la modalità di conversione dell'entità e del contesto. L'implementazione di Microsoft WinSNMP archivia la modalità in un database.

L'impostazione della modalità di conversione 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 restituisce l'entità predefinita corrente e la modalità di conversione del contesto nel parametro nTranslateMode della 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.

Seguire le modalità di conversione dell'entità e del contesto valide.

Mode	Significato
SNMPAPI_TRANSLATED	L'implementazione usa il database per tradurre nomi descrittivi 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 di entità SNMP come indirizzi di trasporto SNMP letterali e parametri di contesto come stringhe della community SNMP letterale. 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 di entità SNMP come indirizzi di trasporto SNMP e i parametri di contesto come stringhe della community SNMP letterale. Per le entità di destinazione SNMPv2, l'implementazione crea messaggi SNMP in uscita che contengono un valore 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 impostando un'applicazione WinSNMP, è necessario chiamare la funzione SnmpSetTranslateMode . Se la modalità di conversione richiesta non è valida, la funzione ha esito negativo e SnmpGetLastError restituisce il codice di errore SNMPAPI_MODE_INVALID.