SnmpDuplicateVbl, 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. Au lieu de cela, utilisez La gestion à distance Windows, qui est l’implémentation Microsoft de WS-Man.]
La fonction SnmpDuplicateVbl WinSNMP copie une liste de liaisons de variables pour la session WinSNMP spécifiée. Cette fonction retourne un handle à la liste des liaisons de variables copiées et lui alloue toute la mémoire nécessaire.
Syntaxe
HSNMP_VBL SNMPAPI_CALL SnmpDuplicateVbl(
[in] HSNMP_SESSION session,
[in] HSNMP_VBL vbl
);
Paramètres
[in] session
Gérez la session WinSNMP.
[in] vbl
Gérez dans la liste des liaisons de variables à copier. La liste des liaisons de variables sources peut être vide.
Valeur retournée
Si la fonction réussit, la valeur de retour est un handle vers une nouvelle liste de liaisons de variables.
Si la fonction échoue, la valeur de retour est SNMPAPI_FAILURE. Pour obtenir des informations d’erreur étendues, appelez SnmpGetLastError. 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 de session n’est pas valide. |
|
Le paramètre vbl n’est pas valide. |
|
Une erreur inconnue ou non définie s’est produite. |
Remarques
La fonction SnmpDuplicateVbl crée une liste de liaisons de variables pour la session WinSNMP spécifiée. Cette fonction initialise la nouvelle liste avec une copie des données dans la liste des liaisons de variables sources.
Le handle retourné par la fonction SnmpDuplicateVbl est unique parmi les handles de liste de liaisons de variables actifs dans l’application WinSNMP.
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 dans un appel ultérieur à SnmpCreateVbl ou SnmpDuplicateVbl. 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 |