SnmpMgrStrToOid, fonction (mgmtapi.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 SnmpMgrStrToOid convertit le format de chaîne d’un identificateur d’objet en sa structure d’identificateur d’objet interne. Cette fonction est un élément de l’API gestion SNMP.

Syntaxe

BOOL SNMP_FUNC_TYPE SnmpMgrStrToOid(
  [in]  LPSTR               string,
  [out] AsnObjectIdentifier *oid
);

Paramètres

[in] string

Pointeur vers une chaîne terminée par null à convertir.

[out] oid

Pointeur vers une variable d’identificateur d’objet pour recevoir la valeur convertie.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro.

Remarques

Si la fonction réussit, appelez la fonction SnmpUtilOidFree pour libérer la mémoire allouée pour l’identificateur d’objet converti.

Si une application transmet un identificateur d’objet valide à SnmpMgrStrToOid, mais qu’elle ne parvient pas à obtenir la variable demandée, la syntaxe du groupe système et de l’identificateur d’objet est incorrecte. Cela se produit parce que SnmpMgrStrToOid suppose que l’identificateur d’objet se trouve sous la MIB Internet de la sous-arborescence de gestion.

Vous devez toujours précéder l’identificateur d’objet d’un point (.) pour obtenir le groupe système approprié (par exemple, .1.3.6.1.2.1.1 »). Si une application transmet la variable « 1.3.6.1.2.1.1 », SnmpMgrStrToOid ne peut pas interpréter correctement l’identificateur d’objet.

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

Voir aussi

Fonctions SNMP

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

SnmpMgrOidToStr

SnmpUtilOidFree