SnmpOidCopy, 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. Utilisez plutôt Windows Remote Management, qui est l’implémentation Microsoft de WS-Man.]
La fonction SnmpOidCopy WinSNMP copie un identificateur d’objet SNMP, en allouant toute la mémoire nécessaire pour la copie.
Syntaxe
SNMPAPI_STATUS SNMPAPI_CALL SnmpOidCopy(
[in] smiLPCOID srcOID,
[out] smiLPOID dstOID
);
Paramètres
[in] srcOID
Pointeur vers une structure smiOID à copier.
[out] dstOID
Pointeur vers une structure smiOID pour recevoir une copie de l’identificateur d’objet spécifié par le paramètre srcOID .
Valeur retournée
Si la fonction réussit, la valeur de retour est le nombre de sous-identificateurs dans l’identificateur d’objet copié. Ce nombre est également la valeur du membre len de la structure smiOID vers laquelle pointe le paramètre dstOID .
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 paramètre srcOID n’est pas valide. |
|
Une erreur inconnue ou non définie s’est produite. |
Remarques
Lors de l’entrée, la fonction SnmpOidCopy ignore les membres de la structure smiOID vers laquelle pointe le paramètre dstOID . L’implémentation De Microsoft WinSNMP remplace les membres smiOID si la fonction se termine correctement.
L’application WinSNMP doit appeler la fonction SnmpFreeDescriptor pour permettre à l’implémentation de libérer les ressources allouées au membre ptr de la structure smiOID vers laquelle pointe le paramètre dstOID . Pour plus d’informations, consultez Concepts winSNMP Gestion des données et Libération des descripteurs 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 |