SnmpDuplicatePdu, 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 SnmpDuplicatePdu WinSNMP duplique l’unité de données de protocole SNMP (PDU) que le paramètre PDU identifie, en allouant toute la mémoire nécessaire pour le PDU en double.
Syntaxe
HSNMP_PDU SNMPAPI_CALL SnmpDuplicatePdu(
[in] HSNMP_SESSION session,
[in] HSNMP_PDU PDU
);
Paramètres
[in] session
Gérez la session WinSNMP.
[in] PDU
Gérez vers le PDU à dupliquer. La fonction SnmpDuplicatePdu fournit un handle unique à chaque PDU au sein de l’application appelante.
Valeur retournée
Si la fonction réussit, la valeur de retour est un handle qui identifie le nouveau PDU en double.
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 handle PDU n’est pas valide. |
|
Une erreur inconnue ou non définie s’est produite. |
Remarques
Pour libérer les ressources allouées par la fonction SnmpDuplicatePdu pour une nouvelle PDU, une application WinSNMP doit appeler la fonction SnmpFreePdu .
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 |