Condividi tramite


Funzione SnmpCancelMsg (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.

Un'applicazione WinSNMP chiama la funzione SnmpCancelMsg per richiedere che l'implementazione di Microsoft WinSNMP annulla i tentativi di ritrasmissione e le notifiche di timeout per un messaggio di richiesta SNMP. La funzione SnmpCancelMsg è un elemento dell'API WinSNMP, versione 2.0.

Sintassi

SNMPAPI_STATUS SNMPAPI_CALL SnmpCancelMsg(
  [in] HSNMP_SESSION session,
  [in] smiINT32      reqId
);

Parametri

[in] session

Gestire la sessione WinSNMP che ha inviato il messaggio di richiesta SNMP (PDU) da annullare.

[in] reqId

Specifica un valore numerico univoco che identifica la PDU di interesse. Questo parametro deve corrispondere all'identificatore di richiesta (request_id) del parametro PDU specificato nella chiamata iniziale dell'applicazione alla funzione SnmpSendMsg .

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 estese sull'errore, chiamare SnmpGetLastError. La funzione SnmpGetLastError può restituire uno degli errori seguenti.

Codice restituito Descrizione
SNMPAPI_SESSION_INVALID
Il parametro di sessione non è valido.
SNMPAPI_PDU_INVALID
Il parametro reqId non identifica un messaggio in sospeso per la sessione specificata.
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

La chiamata alla funzione SnmpCancelMsg equivale a chiamare la funzione SnmpSetRetransmitMode , per un messaggio SNMP specifico, con la modalità di ritrasmissione uguale a SNMPAPI_OFF.

Per altre informazioni, vedere Annullamento della 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

SnmpSendMsg

SnmpSetRetransmitMode

Funzioni WinSNMP

Panoramica dell'API WinSNMP