外掛式接收配接器介面

隔離接收配接器裝載于進程空間中，而不是BizTalk Server進程。 若要與「傳訊引擎」互動，外掛式接收配接器會在啟動時進行註冊，讓引擎能對它進行設定和控制。 配接器會建立傳輸 Proxy、查詢 介面 IBTTransportProxy，並呼叫 IBTTransportProxy.RegisterIsolatedReceiver 向 Messaging Engine 註冊其 IBTTransportConfig 回呼介面。 此同步呼叫會在配接器將第一則訊息提交至BizTalk Server之前發生。 這可讓傳訊引擎回呼配接器，告訴它哪些結束點作用中並應接聽是否有內送訊息。 外掛式配接器必須實作下列介面：

• IBTTransport

• IBTTransportConfig

• IBaseComponent

• IPersistPropertyBag

  若要註冊配接器，配接器必須傳遞已設定和啟用的接收位置。 此配接器的主控件處理序必須是 BizTalk 外掛式主控件使用者群組的成員。 此外，也會查詢此配接器，確定它有正確類別識別碼，而且正在已針對該主控件執行個體設定的電腦上執行。

  成功向傳輸 Proxy 註冊配接器之後，傳訊引擎會分別呼叫IPERsistPropertyBag介面的Load方法，以及IBTTransportConfig介面的AddReceiveEndpoint方法，將組態資訊和其他接收位置傳回介面卡。

  當隔離接收配接器結束處理訊息並即將終止時，它必須呼叫IBTTransportProxy介面的TerminateIsolatedReceiver方法。

  下圖顯示在建立外掛式接收配接器時所牽涉的物件互動。

  
  初始化外掛式接收配接器的工作流程。

注意

我們建議介面卡追蹤目前執行BizTalk Server的要求。 配接器應該封鎖 Terminate 方法，直到工作計數達到零為止。 在接收端，這項工作包含尚未發行至BizTalk Server的任何未處理要求。 請注意，呼叫 Terminate 之後，回應訊息通常不會傳遞至接收配接器。 一般而言，配接器呼叫 Terminate 方法之後，傳訊引擎不接受發佈新訊息的要求，但請求-回應配對的回應訊息除外。

注意

一個程序可能裝載數個外掛式配接器執行個體，但一個程序只能裝載一個配接器。

另請參閱

配接器變數
開發接收配接器
具現化並初始化接收配接器
內含式接收配接器介面
批次支援接收配接器介面
交易式批次支援接收配接器介面
同步要求-回應接收配接器介面