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 |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour