Funzione SnmpGetTimeout (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 SnmpGetTimeout WinSNMP restituisce il valore di timeout, in centesimi di secondo, 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.
Sintassi
SNMPAPI_STATUS SNMPAPI_CALL SnmpGetTimeout(
[in] HSNMP_ENTITY hEntity,
[out] smiLPTIMETICKS nPolicyTimeout,
[out] smiLPTIMETICKS nActualTimeout
);
Parametri
[in] hEntity
Gestire l'entità di gestione della destinazione di interesse.
[out] nPolicyTimeout
Puntatore a una variabile integer per ricevere il valore di timeout, in centesimi di secondo, per l'entità di gestione specificata. Si tratta di un valore che l'implementazione di Microsoft WinSNMP archivia in un database. Se non sono necessarie le informazioni restituite in questo parametro, nPolicyRetry deve essere un puntatore NULL .
[out] nActualTimeout
Puntatore a una variabile integer per ricevere l'ultimo intervallo di risposta effettivo o stimato per l'entità di destinazione, come segnalato dall'implementazione. Se non sono necessarie le informazioni restituite in questo parametro, nActualRetry deve essere un puntatore NULL . Se questo parametro è un puntatore valido, la funzione restituisce 0. Per altre informazioni, vedere la sezione Osservazioni seguenti.
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 |
|---|---|
|
La funzione SnmpStartup non è stata completata correttamente. |
|
Errore durante l'allocazione della memoria. |
|
Il parametro hEntity non è valido. |
|
I parametri nPolicyRetry e nActualRetry sono entrambi NULL. L'operazione non è stata eseguita. |
|
Si è verificato un errore sconosciuto o non definito. |
Commenti
In genere un'applicazione WinSNMP, anziché un'applicazione agente, chiama la funzione SnmpGetTimeout .
Il periodo di timeout è l'intervallo tra la chiamata dell'applicazione alla funzione SnmpSendMsg e la relativa chiamata alla funzione SnmpRecvMsg .
Un'applicazione WinSNMP può modificare il valore di timeout con una chiamata alla funzione SnmpSetTimeout .
L'applicazione WinSNMP può monitorare il valore del parametro nActualRetry e confrontarlo con il valore del parametro nPolicyRetry per ottimizzare le prestazioni della trasmissione. 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 |