Funzione SnmpSetRetransmitMode (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 WinSNMP SnmpSetRetransmitMode consente a un'applicazione WinSNMP di impostare la modalità di ritrasmissione. L'implementazione di Microsoft WinSNMP usa la nuova modalità di ritrasmissione per gestire i timeout della trasmissione e i tentativi di ritrasmissione sulle chiamate successive alla funzione SnmpSendMsg .

Sintassi

SNMPAPI_STATUS SNMPAPI_CALL SnmpSetRetransmitMode(
  [in] smiUINT32 nRetransmitMode
);

Parametri

[in] nRetransmitMode

Specifica un valore per la nuova modalità di ritrasmissione. Questo parametro deve essere uno dei valori seguenti.

Valore	Significato
SNMPAPI_ON	L'implementazione esegue i criteri di ritrasmissione dell'applicazione WinSNMP.
SNMPAPI_OFF	L'implementazione non esegue i criteri di ritrasmissione dell'applicazione WinSNMP.

Valore restituito

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

Se la funzione ha esito negativo, il valore restituito è 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 ritrasmissione richiesta.
SNMPAPI_OTHER_ERROR	Si è verificato un errore sconosciuto o non definito.

Commenti

In genere un'applicazione di gestione WinSNMP, anziché un'applicazione agente, chiama la funzione SnmpSetRetransmitMode .

Se un'applicazione WinSNMP imposta la modalità di ritrasmissione su SNMPAPI_OFF, l'implementazione non avvia tentativi di ritrasmissione per le nuove operazioni di comunicazione SNMP. La nuova impostazione influisce su tutte le chiamate successive alla funzione SnmpSendMsg , fino a quando l'applicazione WinSNMP imposta nuovamente la modalità di ritrasmissione su SNMPAPI_ON.

La chiamata alla funzione SnmpCancelMsg equivale a chiamare la funzione SnmpSetRetransmitMode , per un messaggio SNMP specifico, con la modalità di ritrasmissione uguale a SNMPAPI_OFF.

Nota Se l'implementazione restituisce l'errore SNMPAPI_MODE_INVALID a una chiamata a SnmpSetRetransmitMode, l'applicazione WinSNMP deve eseguire i criteri di ritrasmissione.

Per altre informazioni, vedere Informazioni sulla ritrasmissione e sulla gestione dei criteri di ritrasmissione.

Requisiti


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