Platform SDK: Network Management |
The SnmpMgrStrToOid function converts the string format of an object identifier to its internal object identifier structure. This function is an element of the SNMP Management API.
BOOL SnmpMgrStrToOid( LPSTR string, // string to convert AsnObjectIdentifier *oid // object identifier representation );
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. This function does not return Windows Sockets error codes.
If an application passes a valid object identifier to SnmpMgrStrToOid, yet is unable to obtain the requested variable, then the syntax of the system group and object identifier is incorrect. This occurs because SnmpMgrStrToOid assumes that the object identifier is under the Internet MIB of the management subtree.
You must always precede the object identifier with a period (.) to obtain the correct system group (for example, ".1.3.6.1.2.1.1"). If an application passes the variable "1.3.6.1.2.1.1", SnmpMgrStrToOid cannot interpret the object identifier correctly.
Windows NT/2000: Requires Windows NT 3.1 or later.
Windows 95/98: Unsupported.
Header: Declared in Mgmtapi.h.
Library: Use Mgmtapi.lib.
Simple Network Management Protocol (SNMP) Overview, SNMP Functions, SnmpMgrOidToStr