Fonction SnmpFreeContext (winsnmp.h)

Article
08/27/2023

[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 SnmpFreeContext WinSNMP libère des ressources associées à un contexte SNMP, qui est un ensemble de ressources d’objet managées.

Syntaxe

SNMPAPI_STATUS SNMPAPI_CALL SnmpFreeContext(
  [in] HSNMP_CONTEXT context
);

Paramètres

[in] context

Gérez le contexte 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
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_CONTEXT_INVALID	Le paramètre de contexte n’est pas valide.
SNMPAPI_OTHER_ERROR	Une erreur inconnue ou non définie s’est produite.

Remarques

Lorsque l’application WinSNMP appelle la fonction SnmpClose ou la fonction SnmpCleanup , l’implémentation 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 avec la fonction WinSNMP qui correspond à la ressource. Par exemple, les applications doivent appeler la fonction SnmpFreeContext pour libérer les ressources allouées par un appel à la fonction SnmpStrToContext . Cela réduit la charge de travail de l’implémentation et devrait 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


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

Vue d’ensemble de l’API WinSNMP