IVssCreateWriterMetadataEx：：AddExcludeFilesFromSnapshot 方法 (vswriter.h)
報告建立陰影複製時寫入器明確排除的任何 檔案集 。
呼叫這個方法並不會排除檔案。 寫入器負責從其 CVssWriter：：OnPostSnapshot 方法中的陰影複製中刪除檔案。
語法
HRESULT AddExcludeFilesFromSnapshot(
[in] LPCWSTR wszPath,
[in] LPCWSTR wszFilespec,
[in] bool bRecursive
);
參數
[in] wszPath
Null 終止寬字元字串的指標，其中包含要排除檔案的根目錄。
目錄可以是 VSS 電腦上的本機目錄，也可以是遠端檔案檔案上的檔案共享目錄。
支援 UNC 路徑。
路徑可以包含環境變數 (，例如%SystemRoot%) ，但不能包含通配符。
路徑結尾不需要反斜杠 (“”) 。 這是擷取這項資訊的應用程式，以檢查路徑是否以反斜杠結尾。
[in] wszFilespec
Null 終止寬字元字串的指標，其中包含要排除之檔案的檔案規格。
例如，檔案規格不能包含目錄規格 (，沒有反斜杠) 但可以包含 ？ 和 * 通配符。
[in] bRecursive
布爾值，指定 wszPath 參數所指定的路徑是否只識別單一目錄，或指出要以遞歸方式周遊的目錄階層。 如果路徑被視為要遞歸的目錄階層，則此參數應設定為 true ，否則為 false 。
如需周遊已掛接資料夾的相關信息，請參閱 使用掛接的資料夾和重新分析點。
傳回值
以下是此方法的有效傳回碼。
| 值 | 意義 |
|---|---|
|
作業成功。 |
|
其中一個參數值無效。 |
|
呼叫端記憶體不足或其他系統資源。 |
|
XML 檔無效。 請檢查事件記錄檔以取得詳細數據。 如需詳細資訊，請參閱 VSS 下的事件和錯誤處理。 |
|
Express 寫入器不支援這個方法。 |
|
非預期的錯誤。 錯誤碼會記錄在錯誤記錄檔中。 如需詳細資訊，請參閱 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 Vista、Windows Server 2008、Windows XP 和 Windows Server 2003： 除非 Windows 8 和 Windows Server 2012，否則不支援遠端檔案共用。
AddExcludeFilesFromSnapshot 方法的使用是選擇性的。 寫入器應該只針對在陰影複製作業之間大幅變更的大型檔案使用這個方法。
這個方法不是 IVssCreateWriterMetadata：：AddExcludeFiles 方法的替代方法。 寫入器應該繼續使用 AddExcludeFiles 方法來報告從備份中排除哪些 檔案集 。
呼叫端負責呼叫 IUnknown：：Release 方法來釋放傳回 之 IVssWMFiledesc 對象的資源。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | vswriter.h (包括 Vss.h、VsWriter.h) |
| 程式庫 | VssApi.lib |
另請參閱
IVssCreateWriterMetadata：：AddExcludeFiles