Fonction SnmpFreePdu (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. Au lieu de cela, utilisez La gestion à distance Windows, qui est l’implémentation Microsoft de WS-Man.]
La fonction SnmpFreePdu WinSNMP libère les ressources associées à une unité de données de protocole SNMP (PDU) créée par la fonction SnmpCreatePdu ou SnmpDuplicatePdu .
Syntaxe
SNMPAPI_STATUS SNMPAPI_CALL SnmpFreePdu(
[in] HSNMP_PDU PDU
);
Paramètres
[in] PDU
Gérez le PDU SNMP pour 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 |
|---|---|
|
La fonction SnmpStartup ne s’est pas terminée correctement. |
|
Une erreur s’est produite lors de l’allocation de mémoire. |
|
Le handle PDU n’est pas valide. |
|
Une erreur inconnue ou non définie s’est produite. |
Remarques
Si l’application appelle la fonction SnmpClose ou SnmpCleanup , l’implémentation de Microsoft WinSNMP libère toutes les ressources qu’elle alloue pour la session WinSNMP. Toutefois, il est recommandé que l’application libère des ressources individuelles avec la fonction WinSNMP qui correspond à la ressource. 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. L’application doit utiliser la fonction SnmpFreeVbl pour libérer les ressources de liste des liaisons de variables. Pour plus d’informations, consultez Concepts de Gestion des données WinSNMP.
Sous WinSNMP, une entrée de liaison de variable n’existe que dans une liste de liaisons de variables, même si la liste des liaisons de variables ne contient qu’une seule entrée.
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 |