Funzione SnmpGetLastError (winsnmp.h)

Articolo
03/04/2024

[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 SnmpGetLastError WinSNMP restituisce il valore dell'ultimo codice di errore dell'applicazione chiamante. Il valore indica il motivo per cui l'ultima chiamata di funzione eseguita dall'applicazione WinSNMP non è riuscita.

Sintassi

SNMPAPI_STATUS SNMPAPI_CALL SnmpGetLastError(
  [in] HSNMP_SESSION session
);

Parametri

[in] session

Gestire la sessione WinSNMP. Questo parametro può anche essere NULL.

In alcuni casi, quando una chiamata di funzione ha esito negativo, è possibile passare un valore di sessioneNULL alla funzione SnmpGetLastError per recuperare il valore di codice dell'ultimo errore. Ciò vale per le chiamate di funzione che non coinvolgono un parametro di sessione e i casi in cui il valore del parametro di sessione non è valido. Questi casi sono indicati nella sezione Valori restituiti nella pagina di riferimento della funzione.

Un'applicazione a thread singolo può passare un valore di sessioneNULL a SnmpGetLastError per recuperare le informazioni sull'ultimo errore per l'intera applicazione.

Per altre informazioni, vedere le sezioni Osservazioni e Valori restituiti seguenti.

Valore restituito

Se il parametro di sessione è un handle di sessione WinSNMP valido, la funzione SnmpGetLastError restituisce l'ultimo errore WinSNMP che si è verificato per la sessione indicata.

Se il parametro di sessione è NULL , ad esempio se la funzione SnmpStartup ha esito negativo, SnmpGetLastError restituisce l'ultimo errore WinSNMP che si è verificato.

Commenti

Un'applicazione WinSNMP deve chiamare SnmpGetLastError immediatamente dopo un errore di una funzione, per recuperare l'ultimo codice di errore. Se un'altra funzione ha esito negativo, sovrascrive il codice di ultimo errore impostato dalla funzione non riuscita più di recente. Per altre informazioni, vedere Codici di errore WinSNMP.

Anche se il parametro di sessione supporta sia ambienti operativi Windows multithread che a thread singolo, il potenziale esiste ancora per il codice dell'ultimo errore da un thread per sovrascrivere l'ultimo codice di errore da un altro thread.

Si noti che SnmpGetLastError deve essere in grado di restituire l'ultimo codice di errore a un'applicazione WinSNMP nelle condizioni seguenti:

Dopo che la funzione SnmpStartup ha esito negativo
Prima che la funzione SnmpCreateSession crei tutte le sessioni WinSNMP per l'istanza dell'applicazione
Dopo che la funzione SnmpClose chiude tutte le sessioni WinSNMP per l'istanza dell'applicazione
Dopo che la funzione SnmpCleanup disconnette l'applicazione WinSNMP dall'implementazione di Microsoft WinSNMP

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