SnmpClose, fonction (winsnmp.h)

  • Article

[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 SnmpClose permet à l’implémentation Microsoft WinSNMP de libérer de la mémoire, des ressources et des structures de données associées à une session WinSNMP. La fonction SnmpClose WinSNMP ferme également les mécanismes de communication que l’implémentation a ouverts à la suite d’un appel à la fonction SnmpCreateSession .

Syntaxe

SNMPAPI_STATUS SNMPAPI_CALL SnmpClose(
  [in] HSNMP_SESSION session
);

Paramètres

[in] session

Gérez la session WinSNMP à fermer.

Valeur retournée

Si la fonction réussit, la valeur de retour est SNMPAPI_SUCCESS.

Si la fonction échoue, la valeur de retour est SNMPAPI_FAILURE. Pour obtenir des informations d’erreur étendues, appelez SnmpGetLastError en spécifiant une valeur NULL dans son paramètre de session . La fonction SnmpGetLastError peut retourner l’une des erreurs suivantes.

Code de retour Description
SNMPAPI_NOT_INITIALIZED
 La fonction SnmpStartup ne s’est pas terminée correctement.
SNMPAPI_ALLOC_ERROR
 Une erreur s’est produite lors de l’allocation de mémoire.
SNMPAPI_SESSION_INVALID
 Le paramètre de session n’est pas valide.
SNMPAPI_OTHER_ERROR
 Une erreur inconnue ou non définie s’est produite.

Remarques

Il est recommandé qu’une application WinSNMP appelle la fonction SnmpClose une fois pour chaque session ouverte par l’application à l’aide de la fonction SnmpCreateSession . Si une application WinSNMP se termine de manière inattendue, elle doit appeler SnmpCleanup avant de se terminer pour permettre à l’implémentation de libérer toutes les ressources. L’implémentation traite un appel SnmpCleanup comme s’il s’agissait d’une série d’appels SnmpClose , un appel pour chaque session ouverte suite à un appel à SnmpCreateSession.

Lorsque l’implémentation ferme une session, elle ignore toutes les demandes asynchrones entrantes et sortantes en attente et toutes les réponses pour la session. Pour plus d’informations, consultez Sessions 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

Voir aussi

SnmpCleanup

SnmpCreateSession

Fonctions WinSNMP

Vue d’ensemble de l’API WinSNMP