SnmpDuplicatePdu, fonction (winsnmp.h)

  • Article

[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
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_SESSION_INVALID
 Le handle de session n’est pas valide.
SNMPAPI_PDU_INVALID
 Le handle PDU n’est pas valide.
SNMPAPI_OTHER_ERROR
 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

Voir aussi

SnmpFreePdu

SnmpGetPduData

Fonctions WinSNMP

Vue d’ensemble de l’API WinSNMP