IVssComponent：：GetRestoreMetadata 方法 (vswriter.h)

GetRestoreMetadata方法會擷取CVssWriter：：OnPreRestore使用IVssComponent：：SetRestoreMetadata在PreRestore事件期間設定的私人寫入器特定還原中繼資料。

只有寫入器可以呼叫這個方法。

語法

HRESULT GetRestoreMetadata(
  [out] BSTR *pbstrRestoreMetadata
);

[out] pbstrRestoreMetadata

包含還原中繼資料的字串。

以下是此方法的有效傳回碼。

值	意義
S_OK	已成功傳回屬性值。
S_FALSE	指定的屬性沒有值。
E_INVALIDARG	其中一個參數值無效。
E_OUTOFMEMORY	呼叫端記憶體不足或其他系統資源。
VSS_E_INVALID_XML_DOCUMENT	XML 檔無效。請檢查事件記錄檔以取得詳細資料。如需詳細資訊，請參閱 VSS 下的事件和錯誤處理。

根據指定寫入器的邏輯，您可以隨時呼叫這個方法。

呼叫端應該藉由呼叫SysFreeString釋放pbstrRestoreMetadata參數所持有的記憶體。

如果未設定任何備份中繼資料， GetBackupMetadata 會傳回S_FALSE。

將還原方法設定為VSS_RME_RESTORE_TO_ALTERNATE_LOCATION的寫入器，而不定義替代位置對應會構成寫入器錯誤。