設定實體和內容轉譯模式

WinSNMP 應用程式可以藉由設定實體和內容轉譯模式來指定實體和內容參數的解譯和轉譯。 Microsoft WinSNMP 實作會將模式儲存在資料庫中。

實體和內容轉譯模式的設定會決定 SnmpStrToEntity 函式和 SnmpStrToCoNtext 函式解譯輸入字串的方式。 此設定也會決定 SnmpEntityToStr 和 SnmpCoNtextToStr 函式傳回的輸出字串類型。 如需詳細資訊，請參閱 WinSNMP 中的 IPX 位址字串支援。

實作會在SnmpStartup函式的nTranslateMode參數中傳回目前的預設實體和內容轉譯模式。 若要擷取實作有效的目前實體和內容轉譯模式，應用程式可以隨時呼叫 SnmpGetTranslateMode 函式。

有效的實體和內容轉譯模式如下。

[模式]	意義
SNMPAPI_TRANSLATED	實作會使用其資料庫來翻譯 SNMP 實體和 Managed 物件的使用者易記名稱。 實作會將它們轉譯成其 SNMPv1 或 SNMPv2C 元件。
SNMPAPI_UNTRANSLATED_V1	實作會將 SNMP 實體參數解譯為常值 SNMP 傳輸位址，並將內容參數解譯為常值 SNMP 社群字串。 針對 SNMPv2 目的地實體，實作會建立在版本欄位中包含零值的傳出 SNMP 訊息。
SNMPAPI_UNTRANSLATED_V2	實作會將 SNMP 實體參數解譯為 SNMP 傳輸位址，並將內容參數解譯為常值 SNMP 社群字串。 針對 SNMPv2 目的地實體，實作會建立包含版本欄位中 1 值的傳出 SNMP 訊息。

 

實作會嘗試將資料庫中的資源與管理實體的常值傳輸位址產生關聯。

若要變更 WinSNMP 應用程式的實體和內容轉譯模式設定，必須呼叫 SnmpSetTranslateMode 函式。 如果要求的轉譯模式無效，則函式會失敗， 而 SnmpGetLastError 會傳回錯誤碼SNMPAPI_MODE_INVALID。