SnmpMgrStrToOid

Overview

Group

Quick Info

Windows NT
Yes
Win95
No
Win32s
No
Import Library
mgmtapi.lib
Header File
mgmtapi.h
Unicode
No
Platform Notes
None

The SnmpMgrStrToOid function converts a string object identifier or object descriptor representation to an internal object identifier.

BOOL SnmpMgrStrToOid(

LPSTR string,	// string object identifier to be converted
AsnObjectIdentifier *oid	// object identifier internal representation
);

Parameters
string

[in] Points to a null-terminated string to be converted.

oid
[out] Points to an object identifier variable that will receive the converted value.

Return Values
If the function succeeds, the return value is TRUE.

If the function fails, the return value is FALSE. This function does not return Windows Sockets error codes.

Remarks
The SnmpMgrStrToOid function looks for the file MIB.BIN. If the function does not find the file, it generates an error.

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.