共用方式為

IVssCreateExpressWriterMetadata：：AddFilesToFileGroup 方法 (vswriter.h)

  • 發行項

將檔案集 (指定的檔案或檔案) 新增至快速寫入器的指定檔案群組元件。

語法

HRESULT AddFilesToFileGroup(
  [in] LPCWSTR wszLogicalPath,
  [in] LPCWSTR wszGroupName,
  [in] LPCWSTR wszPath,
  [in] LPCWSTR wszFilespec,
  [in] bool    bRecursive,
  [in] LPCWSTR wszAlternateLocation,
  [in] DWORD   dwBackupTypeMask
);

參數

[in] wszLogicalPath

Null終止寬字元字串的指標，其中包含邏輯路徑 (，可能是要新增檔案之元件的Null) 。 如需詳細資訊，請參閱 元件的邏輯路徑。

[in] wszGroupName

包含檔案群組元件名稱之 Null終止寬字元字串的指標。 此元件的類型必須VSS_CT_FILEGROUP;否則，方法會傳回錯誤。

[in] wszPath

Null終止寬字元字串的指標，其中包含要加入之檔案的預設根目錄。

路徑可以包含環境變數 (例如%SystemRoot%) ，但不能包含萬用字元。

路徑結尾不需要反斜線 (\) 。 它由擷取這項資訊以檢查的應用程式決定。

[in] wszFilespec

Null終止寬字元字串的指標，其中包含要包含之檔案的檔案規格。

例如，檔案規格不能包含目錄規格 (，沒有反斜線) 但可以包含 ？ 和 * 萬用字元。

[in] bRecursive

布林值，指定 wszPath 參數所指定的路徑是否只識別單一目錄，或指出要以遞迴方式周遊的目錄階層。 如果路徑被視為要遞迴的目錄階層，則此參數應設定為 true ，否則為 false 。

如需周遊已掛接資料夾的相關資訊，請參閱 使用掛接的資料夾和重新分析點。

[in] wszAlternateLocation

此參數是保留的，而且必須是 Null。

[in] dwBackupTypeMask

VSS_FILE_SPEC_BACKUP_TYPE列舉值的位元遮罩，指出寫入器是否應該評估檔案以參與特定類型的備份作業。

此參數不能包含 VSS_FSBT_DIFFERENTIAL_BACKUP_REQUIRED、 VSS_FSBT_INCREMENTAL_BACKUP_REQUIRED或 VSS_FSBT_LOG_BACKUP_REQUIRED。

此引數的預設值為 (VSS_FSBT_ALL_BACKUP_REQUIRED |VSS_FSBT_ALL_SNAPSHOT_REQUIRED) 。

傳回值

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

值 意義
S_OK
 作業成功。
E_INVALIDARG
 其中一個參數值無效，或呼叫端嘗試將檔案群組檔案新增至非檔案群組元件。
E_OUTOFMEMORY
 呼叫端記憶體不足或其他系統資源。
VSS_E_INVALID_XML_DOCUMENT
 XML 檔無效。 請檢查事件記錄檔以取得詳細資料。 如需詳細資訊，請參閱 VSS 下的事件和錯誤處理。
VSS_E_OBJECT_NOT_FOUND
 指定的元件不存在。
VSS_E_UNEXPECTED
 非預期的錯誤。 錯誤碼會記錄在錯誤記錄檔中。 如需詳細資訊，請參閱 VSS 下的事件和錯誤處理。

Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 在 Windows Server 2008 R2 和 Windows 7 之前，不支援此值。 E_UNEXPECTED改用。

規格需求

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

另請參閱

IVssCreateExpressWriterMetadata