Funzione SnmpGetRetransmitMode (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 SnmpGetRetransmitMode WinSNMP restituisce l'impostazione corrente della modalità di ritrasmissione in un'applicazione WinSNMP. L'implementazione di Microsoft WinSNMP usa la modalità di ritrasmissione per gestire i tentativi di timeout della trasmissione e ritrasmissione sulle chiamate alla funzione SnmpSendMsg .

Sintassi

SNMPAPI_STATUS SNMPAPI_CALL SnmpGetRetransmitMode(
  [out] smiLPUINT32 nRetransmitMode
);

Parametri

[out] nRetransmitMode

Puntatore a una variabile integer long senza segno per ricevere la modalità di ritrasmissione corrente in effetti per l'implementazione. Questo parametro può avere 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. Se SnmpGetRetransmitMode ha esito negativo, il valore del parametro nRetransmitMode 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

In genere un'applicazione WinSNMP, anziché un'applicazione agente, chiama la funzione SnmpGetRetransmitMode . Per altre informazioni, vedere Informazioni sulla ritrasmissione e sulla gestione dei criteri di ritrasmissione.

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

Vedi anche

SnmpSetRetransmitMode

SnmpStartup

Funzioni WinSNMP

Panoramica dell'API WinSNMP