SnmpGetLastError, fonction (winsnmp.h)

Article
03/04/2024

[SNMP est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt Windows Remote Management, qui est l’implémentation Microsoft de WS-Man.]

La fonction SnmpGetLastError WinSNMP retourne la valeur de code de dernière erreur de l’application appelante. La valeur indique la raison pour laquelle le dernier appel de fonction exécuté par l’application WinSNMP a échoué.

Syntaxe

SNMPAPI_STATUS SNMPAPI_CALL SnmpGetLastError(
  [in] HSNMP_SESSION session
);

Paramètres

[in] session

Gérez la session WinSNMP. Ce paramètre peut également être NULL.

Dans certains cas, lorsqu’un appel de fonction échoue, vous pouvez passer une valeur de sessionNULL à la fonction SnmpGetLastError pour récupérer la valeur de code de la dernière erreur. Cela est vrai pour les appels de fonction qui n’impliquent pas de paramètre de session et les cas où la valeur du paramètre de session n’est pas valide. Ces cas sont notés dans la section Return Values de la page de référence de la fonction.

Une application à thread unique peut passer une valeur de sessionNULL à SnmpGetLastError pour récupérer les informations de dernière erreur pour l’ensemble de l’application.

Pour plus d’informations, consultez les sections Notes et Valeurs de retour suivantes.

Valeur retournée

Si le paramètre de session est un handle de session WinSNMP valide, la fonction SnmpGetLastError retourne la dernière erreur WinSNMP qui s’est produite pour la session indiquée.

Si le paramètre de session a la valeur NULL , par exemple, si la fonction SnmpStartup échoue, SnmpGetLastError retourne la dernière erreur WinSNMP qui s’est produite.

Remarques

Une application WinSNMP doit appeler SnmpGetLastError immédiatement après l’échec d’une fonction pour récupérer le code de la dernière erreur. Si une autre fonction échoue, elle remplace le code de la dernière erreur défini par la fonction ayant échoué le plus récemment. Pour plus d’informations, consultez Codes d’erreur WinSNMP.

Bien que le paramètre de session s’adresse aux environnements d’exploitation Windows multithread et à thread unique, le code de dernière erreur d’un thread peut toujours remplacer le code de dernière erreur d’un autre thread.

Notez que SnmpGetLastError doit être en mesure de retourner le code de la dernière erreur à une application WinSNMP dans les conditions suivantes :

Après l’échec de la fonction SnmpStartup
Avant que la fonction SnmpCreateSession ne crée des sessions WinSNMP pour le instance de l’application
Une fois que la fonction SnmpClose ferme toutes les sessions WinSNMP pour le instance de l’application
Une fois la fonction SnmpCleanup déconnectée l’application WinSNMP de l’implémentation Microsoft WinSNMP

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winsnmp.h
Bibliothèque	Wsnmp32.lib
DLL	Wsnmp32.dll