SnmpFreeVbl, fonction (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. Utilisez plutôt Windows Remote Management, qui est l’implémentation Microsoft de WS-Man.]

La fonction SnmpFreeVbl WinSNMP libère les ressources associées à une liste de liaisons de variables. Il s’agit de ressources allouées précédemment par un appel à la fonction SnmpCreateVbl ou à la fonction SnmpDuplicateVbl dans une application WinSNMP.

Syntaxe

SNMPAPI_STATUS SNMPAPI_CALL SnmpFreeVbl(
  [in] HSNMP_VBL vbl
);

Paramètres

[in] vbl

Gérez la liste des liaisons de variables à libérer.

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_VBL_INVALID	Le paramètre vbl n’est pas valide.
SNMPAPI_OTHER_ERROR	Une erreur inconnue ou non définie s’est produite.

Remarques

L’application WinSNMP doit libérer les ressources associées à chaque liste de liaisons de variables. Pour ce faire, il doit faire correspondre chaque appel aux fonctions SnmpCreateVbl et SnmpDuplicateVbl avec un appel correspondant à la fonction SnmpFreeVbl . Pour éviter les fuites de mémoire, une application WinSNMP doit appeler SnmpFreeVbl avant de réutiliser le handle dans une liste de liaisons de variables lors d’un appel ultérieur à SnmpCreateVbl ou SnmpDuplicateVbl.

Si l’application appelle la fonction SnmpClose ou SnmpCleanup , l’implémentation Microsoft WinSNMP libère toutes les ressources qu’elle alloue pour la session WinSNMP. Toutefois, même si l’application ne réutilise pas de handle de liste de liaisons de variables, il est recommandé que l’application libère des ressources de variable individuelle avec la fonction SnmpFreeVbl . Cela réduit la charge de travail de l’implémentation et doit améliorer son service 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