Funzione SnmpSetTimeout (winsnmp.h)

Articolo
03/13/2024

[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 SnmpSetTimeout WinSNMP consente a un'applicazione WinSNMP di modificare il valore di timeout per la trasmissione di richieste di messaggi SNMP. Il valore di timeout si applica alle chiamate effettuate da un'applicazione WinSNMP alla funzione SnmpSendMsg per un'entità di gestione specificata. L'implementazione di Microsoft WinSNMP archivia il valore in un database.

Sintassi

SNMPAPI_STATUS SNMPAPI_CALL SnmpSetTimeout(
  [in] HSNMP_ENTITY hEntity,
  [in] smiTIMETICKS nPolicyTimeout
);

Parametri

[in] hEntity

Gestire l'entità di gestione della destinazione di interesse.

[in] nPolicyTimeout

Specifica un nuovo valore di timeout, in centesimi di secondo, per l'entità di gestione. Questo valore sostituisce il valore attualmente archiviato nel database dell'implementazione.

Se questo parametro è uguale a zero e la modalità di ritrasmissione corrente è uguale a SNMPAPI_ON, l'implementazione seleziona un valore di timeout. L'implementazione usa questo valore di timeout quando 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_ENTITY_INVALID	Il parametro hEntity non è valido.
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 SnmpSetTimeout .

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