執行復原

[本主題是發行前的文件集，在未來的版本中可能有所變更。空白的主題則以預留位置表示。]

資源管理員會在資源失敗後重新登記交易參與者，以協助解析交易中的永久性登記。

復原程序

若要永久地登記稍後可用於復原的資源 (如 IEnlistmentNotification 介面實作所述)，您應該呼叫 EnlistDurable 方法。此外，您必須提供一個包含資源管理員識別項 (Guid) 的 EnlistDurable 方法，此識別項可在發生資源失敗時，用來為交易參與者持續加上標籤。因此，提供給初始登記呼叫的 Guid 應該與復原期間 Reenlist 呼叫中的 resourceManagerIdentifier 參數一模一樣。否則，會擲回 TransactionException。如需永久性登記的詳細資訊，請參閱將資源登記成為交易中的參與者。

在 2PC 通訊協定準備階段 (第一階段) 中，當您實作的永久性資源管理員收到 Prepare 告知，就應該會在此階段記錄下自己的準備記錄。該記錄應包含完成交易認可所需的所有資訊。您稍後可以在復原期間藉由擷取 preparingEnlistment 回呼 (Callback) 的 RecoveryInformation 屬性來存取準備記錄。由於 RM 可以在背景工作執行緒 (Worker Thread) 上進行記錄，因此您不需要透過 Prepare 方法來執行。

復原程序包含下列兩個步驟：

步驟 1 - 重新登記

資源管理員會檢查每個不確定之登記的準備資訊記錄。它會檢查 PreparingEnlistment 回呼的 RecoveryInformation 屬性，這個屬性會在第一階段透過 Prepare 告知傳遞給資源管理員。

它會針對每個所檢查的此類登記，叫用交易管理員上的 Reenlist。此方法會傳遞可識別資源管理員的唯一 Guid，以及位元組陣列中的登記資訊。隨即會傳回新的 Enlistment 物件。如果重新登記因為例外狀況而失敗，則資源管理員需要在稍後重試。

只有在資源管理員從失敗中重新啟動時，您才應該呼叫 Reenlist 方法。此外，您只應該重新登記無法解析的交易，這些交易是由資源管理員在兩階段交易認可 (Two-Phase Commit) 的初始準備階段所記錄。任何嘗試在無效時間呼叫這個方法的動作，都可能產生錯誤性結果。

當使用這個方法重新登記參與者時，會依適合的情況呼叫對應至交易結果 (也就是，Commit、Rollback 或 InDoubt) 之 IEnlistmentNotification 的第二階段方法。

步驟 2 - 完成復原

完成所有重新登記後，資源管理員就會呼叫 RecoveryComplete 方法。此方法會完成復原並告知交易管理員，資源管理員已不包含任何不確定的交易。當資源管理員這麼做，即保證不會再次叫用 Reenlist 方法。

在登記新的交易之前，不需要透過資源管理員來解析所有不確定的交易。第一個步驟可以在資源管理員與交易管理員建立關係之後隨時執行，但是一旦叫用了 RecoveryComplete (步驟 2)，則無法再次執行步驟 1。步驟 2 可以重複執行多次，而不會影響到交易結果。