SnmpFreeEntity, fonction (winsnmp.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. Utilisez plutôt Windows Remote Management, qui est l’implémentation Microsoft de WS-Man.]
La fonction SnmpFreeEntity WinSNMP libère les ressources associées à une entité de gestion SNMP.
Syntaxe
SNMPAPI_STATUS SNMPAPI_CALL SnmpFreeEntity(
[in] HSNMP_ENTITY entity
);
Paramètres
[in] entity
Gérez l’entité de gestion SNMP dont les ressources seront libérées.
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 |
|---|---|
|
La fonction SnmpStartup ne s’est pas terminée correctement. |
|
Une erreur s’est produite lors de l’allocation de mémoire. |
|
Le paramètre d’entité n’est pas valide. |
|
Une erreur inconnue ou non définie s’est produite. |
Remarques
Lorsque l’application WinSNMP appelle la fonction SnmpClose ou snmpCleanup , l’implémentation De Microsoft WinSNMP libère toutes les ressources qu’elle a allouées pour la session WinSNMP. Toutefois, il est recommandé que l’application WinSNMP libère des ressources individuelles à l’aide de la fonction WinSNMP qui correspond à la ressource. Par exemple, les applications doivent appeler la fonction SnmpFreeEntity pour libérer les ressources allouées par un appel à la fonction SnmpStrToEntity . Cela réduit la charge de travail de l’implémentation et doit améliorer le service de l’implémentation pour toutes les applications.
Pour plus d’informations, consultez Concepts de Gestion des données 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 |