Fonction SnmpMgrClose (mgmtapi.h)
[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. Au lieu de cela, utilisez La gestion à distance Windows, qui est l’implémentation Microsoft de WS-Man.]
La fonction SnmpMgrClose ferme les sockets de communication et les structures de données associés à la session spécifiée. Cette fonction est un élément de l’API gestion SNMP.
Syntaxe
BOOL SNMP_FUNC_TYPE SnmpMgrClose(
[in] LPSNMP_MGR_SESSION session
);
Paramètres
[in] session
Pointeur vers une structure interne qui spécifie la session à fermer. Pour plus d'informations, consultez la section Notes qui suit.
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro.
Cette fonction peut retourner des codes d’erreur Windows Sockets.
Remarques
Windows Server 2003 : Les applications de gestionnaire SNMP peuvent appeler SnmpMgrClose avec un paramètre de sessionNULL pour propre les ressources associées à un appel réussi à la fonction SnmpMgrTrapListen. Notez toutefois que si votre application est une DLL, elle ne doit pas appeler SnmpMgrClose à partir de sa fonction de point d’entrée DllMain .
SnmpMgrClose ne doit pas être appelé lorsque la DLL d’application est en cours de déchargement.
Windows Server 2003 : SnmpMgrClose prend plus de temps à s’exécuter sous Windows Server 2003 par rapport à un appel identique sous Windows 2000. Plus précisément, un appel à cette API prend jusqu’à une seconde pour s’exécuter sous Windows Server 2003, alors que le même appel prend environ 0,3 millisecondes sous Windows 2000. cela peut entraîner des problèmes de performances pour les applications SNMP Windows Server 2003 qui appellent fréquemment SnmpMgrOpen et SnmpMgrClose .
Pour résoudre ce problème, créez une session de gestionnaire SNMP supplémentaire en appelant SnmpMgrOpen sur l’hôte local lors du démarrage de l’application, puis conservez-la ouverte pendant toute la durée de vie de l’application. La fermeture du gestionnaire de sessions ferme toutes les sessions associées, nécessitant un seul appel à SnmpMgrClose.
Windows Server 2003 avec SP1 : Le problème ci-dessus ne s’applique pas à Windows 2003 Service Pack 1.
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 | mgmtapi.h |
| Bibliothèque | Mgmtapi.lib |
| DLL | Mgmtapi.dll |
Voir aussi
Vue d’ensemble du protocole SNMP (Simple Network Management Protocol)