選擇性中繼資料

身為開發人員，您可以選擇讓交易整合器 (TI) 執行時間環境在大型主機交易程式中傳送和接收中繼資料， (TP) ，您可以選擇該中繼資料的內容。

注意

分散式程式呼叫不支援中繼資料， (DPC) 。

您可以傳送或接收：

• 沒有中繼資料。

• 只有方法名稱作為中繼資料。

• 包括方法名稱的所有中繼資料。

  TI 執行時間環境會依指示，在 TP 中傳送或接收中繼資料。 中繼資料可協助 TP：

• 識別中繼資料 (版本資訊) 的格式。

• 識別用來叫用 TP 的方法名稱。

• 將詳細的錯誤資訊回報給用戶端。

  自動化用戶端看不到中繼資料。 中繼資料會傳遞至 (或從) 主機 TP 接收，作為傳送至 (或從 TP 接收) 回應訊息的一部分。

  元資料集包含下列資料：

• TI 執行時間版本。

  字元字串，例如 「Microsoft TI 1.0.0 版」，可唯一識別產生要求的 TI 執行時間環境版本。

• 用戶端應用程式程式碼叫用的方法名稱 (32 個字元字串) 。

• 中繼資料區塊識別碼。

  以字元格式表示的 GUID，可唯一識別這個例外狀況資料區塊。 GUID 支援未來有其他例外狀況格式的能力，並協助確保收到的任何資料都有效。

• 沒有指派用途的變數 (保留) ：

  • 布林值旗標，指出 TP 是否已準備好認可。

  • 布林值旗標，指出 TP 是否準備好執行其他工作。

  • 兩個短整數可保存 TI 執行時間環境版本號碼的片段，一個短整數可保存主要版本號碼，另一個則保存次要版本號碼。

• 例外狀況封鎖 (僅適用于回復) 。

  二進位格式的 GUID，可唯一識別這個例外狀況資料的區塊。 GUID 可在未來支援其他例外狀況格式，並協助確保收到的資料有效：

  • 布林值旗標，指出 TP 是否已準備好認可。

  • 布林值旗標，指出 TP 是否準備好執行其他工作。

  • 布林值旗標，指出是否應該將例外狀況傳回用戶端應用程式。 如果設定，此旗標也會讓交易結束。

  • 16 位整數，可識別錯誤 (請參閱本主題稍後的附注) 。 您可以從伺服器指派此值，以及描述錯誤的 256 個字元訊息，以便在發生 TI 執行時間錯誤時傳回指派的值。

  • 32 位整數，識別 TP 說明檔中的內容識別碼，如果有任何) ， (。

  • 描述錯誤的 256 個字元訊息。 您可以指派此值，以及識別伺服器錯誤的 16 位整數，以便在發生 TI 執行時間錯誤時傳回指派的值。

  中繼資料一律位於訊息的開頭。

注意

TI 錯誤訊息的範圍是從 0 到 9999。 從大型主機傳回的中繼資料錯誤訊息編號可以落在相同的範圍內。 為了區別 TI 錯誤訊息與從大型主機傳回的中繼資料訊息，TI 會將 10000 新增至從大型主機傳回的任何中繼資料錯誤訊息數目。