SnmpOidCopy, 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. 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
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_OID_INVALID
 Le paramètre srcOID n’est pas valide.
SNMPAPI_OTHER_ERROR
 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

SnmpFreeDescriptor

Fonctions WinSNMP

Vue d’ensemble de l’API WinSNMP

smiOID