SnmpUtilIdsToA, fonction (snmp.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 SnmpUtilIdsToA convertit un identificateur d’objet (OID) en chaîne terminée par null. Cette fonction est un élément de l’API de l’utilitaire SNMP.

Syntaxe

LPSTR SNMP_FUNC_TYPE SnmpUtilIdsToA(
  [in] UINT *Ids,
  [in] UINT IdLength
);

Paramètres

[in] Ids

Pointeur vers un tableau d’entiers non signés. Le tableau contient la séquence de nombres que contient l’OID. Le paramètre IdLength spécifie la longueur du tableau.

Pour plus d’informations, consultez les sections Valeurs de retour et Remarques suivantes.

[in] IdLength

Spécifie le nombre d’éléments dans le tableau vers lequel pointe le paramètre Ids .

Valeur retournée

La fonction retourne une chaîne terminée par null qui contient la représentation sous forme de chaîne du tableau de nombres vers lequel pointe le paramètre Ids . La chaîne contient une séquence de nombres séparés par des points ('.') ; par exemple, 1.3.6.1.4.1.311.

Si le paramètre Ids a la valeur null ou si le paramètre IdLength spécifie zéro, la fonction retourne la chaîne «< oid> null ».

La longueur maximale de la chaîne retournée est de 256 caractères. Si la longueur de la chaîne dépasse 256 caractères, la chaîne est tronquée et terminée par une séquence de trois points (« ... »).

Remarques

La fonction SnmpUtilIdsToA peut vous aider à déboguer des applications SNMP.

Notez que les restrictions de mémoire suivantes s’appliquent lorsque vous appelez SnmpUtilIdsToA :

  • Le paramètre Ids doit pointer vers un bloc de mémoire valide contenant au moins des entiers IdLength , sinon l’appel de fonction génère une exception de violation d’accès.
  • La chaîne retournée par SnmpUtilIdsToA réside dans la mémoire que l’API de l’utilitaire SNMP alloue. L’application ne doit pas faire d’hypothèses sur l’allocation de mémoire. La validité des données est garantie jusqu’à ce que vous appeliez à nouveau SnmpUtilIdsToA . Par conséquent, avant d’appeler à nouveau la fonction, vous devez copier les données vers un autre emplacement.

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 snmp.h
Bibliothèque Snmpapi.lib
DLL Snmpapi.dll

Voir aussi

Fonctions SNMP

Vue d’ensemble du protocole SNMP (Simple Network Management Protocol)

SnmpUtilOidToA