共用方式為


轉換器 (TCP/IP)

「TCP/IP 轉換器」建構可讓您使用從特定 MIB (SNMP 管理資訊庫) 物件擷取資料的查詢來延伸 bidi 通訊 綱目,然後將資料轉換成字串值,該值是根據轉換元素中指定的值組清單。 轉換器建構定義在 Tcpbidi.xsd 中。

屬性 說明
裝置索引 (選用)布林值,當 TRUE 時,表示相關聯的演算法必須在指定的 OID 中包含裝置索引;當此屬性為 FALSE 時,尾端零會附加至 OID。 預設值 FALSE。 如需詳細資訊,請參閱下表後面的附註。
drvPrinterEvent (選擇性)布爾值,指出埠監視器是否傳送通知給驅動程式。 TRUE 值表示埠監視器會將通知傳送給驅動程式;FALSE 表示埠監視器不會傳送通知給驅動程式。
名字 代表結構描述元素名稱的字串值。
對象識別碼 表示 MIB 物件位址的字串值,做為物件識別碼 (OID)。
刷新間隔 (選用)輪詢間隔的整數值,以秒為單位。 預設值為 600 秒。
useFirstIndex (選用)布林值,可設定為讀取 MIB 表格中的第一個項目。 只有在 Converter 建構位於 Property 實例內時,才會使用此屬性。

備註

支援 SNMP 通訊協定的網路裝置可以是不同子裝置的主機,例如處理器、網路、印表機和磁碟儲存體。 在網路印表機中實作的 MIB 表格包含以裝置索引為索引的項目。 若要從 MIB 資料表擷取資料(例如輸入 bin 的名稱),查詢必須具有能正確識別子設備的子裝置索引。 標準 TCP/IP 埠監視器允許透過埠配置 UI 手動配置裝置索引。 deviceIndex 屬性設定為 TRUE 的 bidi 延伸模組會產生 OID,其中包含從埠組態 UI 取得的適當裝置索引。 此外,如果 Converter 建構包含在 Property 實例中,且 deviceIndex 屬性遺漏或設定為 FALSE,則 OID 會在其結尾附加零索引。

轉換常式支援下列 MIB 資料類型:

  • 整數

  • Integer32

  • 量測計32

  • Counter32

  • TimeTicks

  • 無符號32位元

  • Counter64

  • 不透明

  • 八位元組字串

  • 物件標識碼

轉換元件

每個轉換器建構都會包含一或多個轉換元素,以定義從 MIB 元素讀取的值對應至 Bidi 架構值。

屬性 說明
mib值 (選用)字串值,代表可從 MIB 讀取的一個可能資料值。
bidi值 (選用)字串值,代表資料符合此轉換元素的 mibValue 屬性時傳回的 bidi 值。

程式碼範例

下列程式碼範例會藉由新增屬性和轉換器建構來擴充 bidi 通訊結構描述。

<Property name="Printer">
  <Property name="Layout">
    <Property name="InputBins">
      <IndexedProperty name="Bin">
        <Converter name="BinType" oid="1.3.6.1.2.1.43.8.2.1.2" deviceIndex="true">
          <Conversion mibValue="2" bidiValue="Unknown"/>
          <Conversion mibValue="3" bidiValue="SheetFeedAutoRemovableTray"/>
          <Conversion mibValue="4" bidiValue="SheetFeedAutoNonRemovableTray"/>
          <Conversion mibValue="5" bidiValue="SheetFeedManual"/>
          <Conversion mibValue="6" bidiValue="ContinuousRoll"/>
          <Conversion mibValue="7" bidiValue="ContinuousFanFold"/>
        </Converter>
      </IndexedProperty>
    </Property>
    <Property name="Orientation">
      <Converter name="CurrentValue" oid="1.3.6.1.2.1.43.15.1.1.7" deviceIndex="true" useFirstIndex="true">
        <Conversion mibValue="3" bidiValue="Portrait"/>
        <Conversion mibValue="4" bidiValue="Landscape"/>
     </Converter>
   </Property>
 </Property>
 <Property name="Custom">
    <Property name="HostResourceMIB">
      <Converter name="InterfaceName" oid="1.3.6.1.2.1.2.1">
      <Conversion mibValue="1" bidiValue="InterfaceOne"/>
    <Conversion mibValue="2" bidiValue="InterfaceTwo"/>
     </Converter>
  </Property>
 </Property
</Property>

上述範例會產生下列查詢。

\Printer.Layout.InputBins.Bin###:BinType
\Printer.Layout.Orientation:CurrentValue
\Printer.Custom.HostResourceMIB:InterfaceName

BinType 的 Converter 結構位於 IndexedProperty 實例中,因此,目前的 MIB 表格資料列條目會自動附加至 OID。

因為 的 CurrentValue 轉換器建構包含在 Property 實例中,而且 useFirstIndex 屬性設定為 “true”,所以尾端 “1” 會自動附加至 OID。

InterfaceName的Converter建構包含在一個Property實例中,因此後綴的零會自動附加至OID。