IVssComponent：：GetDirectedTarget 方法 (vswriter.h)

  • 發行項

GetDirectedTarget 方法會在備份時，將寫入器儲存的資訊傳回至備份元件檔，以指出何時要還原檔案，它會 (來源檔案) 應重新對應。 檔案可以還原至新的還原目標，以及/或還原目標還原至不同位置的數據範圍。

寫入器或要求者可以呼叫這個方法。

語法

HRESULT GetDirectedTarget(
  [in]  UINT iDirectedTarget,
  [out] BSTR *pbstrSourcePath,
  [out] BSTR *pbstrSourceFileName,
  [out] BSTR *pbstrSourceRangeList,
  [out] BSTR *pbstrDestinationPath,
  [out] BSTR *pbstrDestinationFilename,
  [out] BSTR *pbstrDestinationRangeList
);

參數

[in] iDirectedTarget

導向目標的索引編號。 此參數的值是介於 0 到 n-1 的整數，其中 n 是與指定元件相關聯的導向目標總數 (及其子元件，如果它定義元件集) 。 n 的值會由 IVssComponent：：GetDirectedTargetCount 傳回。

[out] pbstrSourcePath

呼叫端配置的變數位址，該變數會接收字串，其中包含在備份階段包含要還原之檔案的路徑， (來源檔案) 。 如果元件定義元件集) ，則此路徑應該符合或位於元件中檔案集的路徑下，或其子元件之一 (。

[out] pbstrSourceFileName

呼叫端配置的變數位址，該變數會接收字串，其中包含備份時 (檔名的字串，) 在還原期間重新對應， (來源檔案) 。 此檔案的名稱不應包含任何通配符，而且必須是與 pbstrSourcePath) 來源路徑相同檔案集的成員 (。

[out] pbstrSourceRangeList

呼叫端配置的變數位址，接收字串，其中包含以逗號分隔的檔案位移清單和長度，指出來源檔案支援範圍 (要還原之檔案的區段) 。

來源檔案支援範圍的數目和長度必須符合目的地檔案支援範圍的數目和大小。

[out] pbstrDestinationPath

呼叫端配置的變數位址，接收字串，其中包含在還原時將重新對應源檔案數據的路徑。

[out] pbstrDestinationFilename

呼叫端配置的變數位址，接收字串，其中包含在還原時將重新對應源檔案數據之檔名的字串。

[out] pbstrDestinationRangeList

呼叫端配置的變數位址，接收字串，其中包含以逗號分隔的檔案位移清單，以及指出目的地檔案支援範圍 (要還原來源檔案區段的位置) 。

目的地檔案支援範圍的數目和長度必須符合來源檔案支援範圍的數目和大小。

傳回值

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

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

備註

如果 GetDirectedTarget 的呼叫成功，呼叫端會負責呼叫 SysFreeString 函式來釋放每個傳回的字串。

只有在還原目標VSS_RT_DIRECTED時，要求者才會使用儲存在備份元件檔中的導向目標資訊。

列出 (wszSourceRanges 和 wszDestinationRanges 的範圍語法) 是 位移 1：length1、offset2：length2 格式的逗號分隔列表，其中每個位移和長度都是 64 位整數，分別指定位元組位移和位元組長度。 位移和長度可以表示為十六進位或十進位值。

GetDirectedTarget 會傳回其導向目標的檔案，可能是目前元件或任何其所定義子元件的成員。

呼叫端應該藉由呼叫 SysFreeString 來釋放 pbstrSourcePath、pbstrSourceFileName、pbstrDestinationPath、pbstrDestinationFilename 和 pbstrDestinationRangeList 參數所持有的記憶體。

如果要備份的部分檔案範圍符合導向的目標來源範圍，則部分檔案可能會新增為導向目標， (請參閱 IVssComponent：：AddPartialFile) 。 這可讓您重新對應部分檔案。

要求者必須檢查導向的目標來源檔案是否已備份為部分檔案，才能正確實作還原。 如果是這種情況，要求者會使用導向目標資訊搭配 IVssComponent：：GetPartialFile () 的部分檔案資訊，在還原期間實作備份數據的重新對應。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 vswriter.h (包括 Vss.h、VsWriter.h)
程式庫 VssApi.lib

另請參閱

IVssComponent

IVssComponent：：AddDirectedTarget

IVssComponent：：GetDirectedTargetCount