SnmpMgrStrToOid
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.
See Also
SnmpMgrOidToStr