Condividi tramite


Funzione SnmpSetRetry (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 SnmpSetRetry WinSNMP consente a un'applicazione WinSNMP di modificare il valore del numero di tentativi per la ritrasmissione delle richieste di messaggi SNMP. Il numero di tentativi 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 SnmpSetRetry(
  [in] HSNMP_ENTITY hEntity,
  [in] smiUINT32    nPolicyRetry
);

Parametri

[in] hEntity

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

[in] nPolicyRetry

Specifica un nuovo valore per il numero di tentativi 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 per il conteggio dei tentativi. L'implementazione usa questo valore quando esegue il criterio di ritrasmissione dell'applicazione WinSNMP.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene SNMPAPI_SUCCESS.

Se la funzione ha esito negativo, il valore restituito viene 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 SnmpSetRetry .

Per altre informazioni, vedere Informazioni sulla ritrasmissione e 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

SnmpGetRetry

SnmpSetRetransmitMode

Funzioni WinSNMP

Panoramica dell'API WinSNMP