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.