snmpMgrStrToOid 函式 (mgmtapi.h)

[SNMP 可用於需求一節中指定的作業系統。它在後續版本中可能會變更或無法使用。請改用 Windows 遠端管理，這是 WS-Man 的 Microsoft 實作。

SnmpMgrStrToOid 函式會將物件標識碼的字串格式轉換成其內部物件標識符結構。此函式是SNMP管理 API 的元素。

語法

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

[in] string

要轉換之 Null 終止字串的指標。

[out] oid

要接收已轉換值的物件標識碼變數指標。

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。

如果函式成功，請呼叫 SnmpUtilOidFree 函式，以釋放配置給已轉換物件標識符的記憶體。

如果應用程式將有效的物件標識碼傳遞至 SnmpMgrStrToOid，但無法取得要求的變數，則系統群組和物件識別碼的語法不正確。這是因為 SnmpMgrStrToOid 假設物件識別碼位於管理子樹的因特網 MIB 之下。

您必須一律在對象標識符前面加上句號 (.) ，才能取得正確的系統群組 (，例如 “.1.3.6.1.2.1.1”。) 。如果應用程式傳遞變數「1.3.6.1.2.1.1」， SnmpMgrStrToOid 就無法正確解譯物件標識碼。