SnmpMgrStrToOid, fonction (mgmtapi.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. 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
Vue d’ensemble du protocole SNMP (Simple Network Management Protocol)