Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
[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 |
|---|---|
|
Il parametro di sessione non è valido. |
|
Il parametro reqId non identifica un messaggio in sospeso per la sessione specificata. |
|
La funzione SnmpStartup non è stata completata correttamente. |
|
Errore durante l'allocazione della memoria. |
|
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 |