Funzione SnmpGetTranslateMode (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 SnmpGetTranslateMode WinSNMP restituisce l'impostazione corrente dell'entità e della modalità di conversione del contesto in un'applicazione WinSNMP. 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 SnmpGetTranslateMode(
  [out] smiLPUINT32 nTranslateMode
);

Parametri

[out] nTranslateMode

Puntatore a una variabile long integer senza segno per ricevere l'entità e la modalità di conversione del contesto in vigore per l'implementazione di Microsoft WinSNMP. Questo parametro può avere uno dei valori seguenti.

Valore	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 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. Se SnmpGetTranslateMode ha esito negativo, il valore del parametro nTranslateMode non ha alcun significato per l'applicazione. 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_OTHER_ERROR	Si è verificato un errore sconosciuto o non definito.

Commenti

La modalità di conversione dell'entità e del contesto influisce sulle chiamate alle funzioni SnmpStrToEntity, SnmpStrToContext, SnmpContextToStr e SnmpEntityToStr . 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