Condividi tramite


Funzione SnmpSetRetransmitMode (winsnmp.h)

[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

Vedi anche

SnmpCancelMsg

SnmpGetRetransmitMode

SnmpGetRetry

SnmpGetTimeout

SnmpRegister

SnmpSendMsg

Funzioni WinSNMP

Panoramica dell'API WinSNMP