Funzione SnmpGetRetry (winsnmp.h)

  • Articolo

[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 SnmpGetRetry WinSNMP restituisce il valore del conteggio dei tentativi, in unità, per la ritrasmissione delle richieste di messaggio SNMP. Il conteggio dei tentativi si applica alle chiamate effettuate da un'applicazione WinSNMP alla funzione SnmpSendMsg per un'entità di gestione specificata.

Sintassi

SNMPAPI_STATUS SNMPAPI_CALL SnmpGetRetry(
  [in]  HSNMP_ENTITY hEntity,
  [out] smiLPUINT32  nPolicyRetry,
  [out] smiLPUINT32  nActualRetry
);

Parametri

[in] hEntity

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

[out] nPolicyRetry

Puntatore a una variabile integer long senza segno per ricevere il valore del conteggio dei tentativi 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] nActualRetry

Puntatore a una variabile integer long senza segno per ricevere l'ultimo conteggio effettivo o stimato dei tentativi per l'entità di destinazione, come indicato 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
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_NOOP
 I parametri nPolicyRetry e nActualRetry sono entrambi NULL. L'operazione non è stata eseguita.
SNMPAPI_OTHER_ERROR
 Si è verificato un errore sconosciuto o non definito.

Commenti

In genere un'applicazione WinSNMP, anziché un'applicazione agente, chiama la funzione SnmpGetRetry .

Un'applicazione WinSNMP può modificare il valore del conteggio dei tentativi con una chiamata alla funzione SnmpSetRetry .

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

Vedi anche

SnmpGetRetransmitMode

SnmpSetRetransmitMode

SnmpSetRetry

Funzioni WinSNMP

Panoramica dell'API WinSNMP