Funzione SnmpSetTranslateMode (winsnmp.h)

Articolo
08/27/2023

[SNMP è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Usare invece Gestione remota Windows, ovvero l'implementazione Microsoft di WS-Man.

La funzione SnmpSetTranslateMode WinSNMP consente a un'applicazione WinSNMP di modificare la modalità di conversione dell'entità e del contesto. La modalità di conversione dell'entità e del contesto influisce sull'interpretazione e sulla restituzione dei parametri di input e di stringa di output WinSNMP.

Sintassi

SNMPAPI_STATUS SNMPAPI_CALL SnmpSetTranslateMode(
  [in] smiUINT32 nTranslateMode
);

Parametri

[in] nTranslateMode

Specifica un valore per la nuova entità e la modalità di conversione del contesto. Questo parametro deve essere uno dei valori seguenti.

Valore	Significato
SNMPAPI_TRANSLATED	L'implementazione di Microsoft WinSNMP usa il relativo 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 e parametri di contesto come stringhe della community SNMP. 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 parametri di contesto come stringhe della community SNMP. Per le entità di destinazione SNMPv2, l'implementazione crea messaggi SNMP in uscita che contengono un valore 1 nel campo della versione.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene SNMPAPI_SUCCESS.

Se la funzione ha esito negativo, il valore restituito viene SNMPAPI_FAILURE. Per ottenere informazioni sull'errore estese, chiamare SnmpGetLastError specificando un valore NULL nel relativo parametro di sessione . La funzione SnmpGetLastError può restituire uno degli errori seguenti.

Codice restituito	Descrizione
SNMPAPI_NOT_INITIALIZED	La funzione SnmpStartup non è stata completata correttamente.
SNMPAPI_ALLOC_ERROR	Errore durante l'allocazione della memoria.
SNMPAPI_MODE_INVALID	L'implementazione non supporta la modalità di conversione richiesta.
SNMPAPI_OTHER_ERROR	Si è verificato un errore sconosciuto o non definito.

Commenti

La nuova modalità di conversione dell'entità e del contesto influisce sulle chiamate successive alle funzioni SnmpStrToEntity, SnmpStrToContext, SnmpContextToStr e SnmpEntityToStr . L'applicazione WinSNMP può modificare di nuovo l'entità e la modalità di conversione del contesto effettuando un'altra chiamata a SnmpSetTranslateMode con un valore nTranslateMode diverso.

Per altre informazioni, vedere Impostazione della modalità di conversione dell'entità e del contesto.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winsnmp.h
Libreria	Wsnmp32.lib
DLL	Wsnmp32.dll