WdCopySearchOptions
指定複製作業的檔案和目錄篩選模式。 推出版本: RIT 0.0.8-Preview。成員類型和可用性因版本而異;請參閱變更歷程記錄。語法
成員
_In_z_ includeFilePattern類型:const char* 指定要包含在複製作業中之檔案的 Glob 模式 (例如,
"*" 包含所有檔案,或 "*.exe;*.dll" 只包含可執行檔和 DLL)。
_In_z_ excludeFilePattern類型:const char* 指定要從複製作業中排除之檔案的 Glob 模式 (例如,
"*.pdb" 排除偵錯符號)。
_In_z_ excludeDirPattern類型:const char* 指定要從複製作業中排除之目錄名稱 (而非路徑) 的 Glob 模式 (例如,
".vs;obj" 排除 Visual Studio 和組建輸出目錄)。
includeFileAttributes類型:uint32_t 檔案屬性的位元遮罩。具有任一指定屬性的檔案會包含在複製中。設定為
0 表示不依屬性篩選。如需檔案屬性的其他資訊,請參閱檔案屬性常數。
excludeFileAttributes類型:uint32_t 會使檔案從複製中排除的檔案屬性位元遮罩。設定為
0 表示不依屬性篩選。如需檔案屬性的其他資訊,請參閱檔案屬性常數。
includeDirectoryAttributes類型:uint32_t 推出版本: RIT 0.0.13-preview。 目錄屬性的位元遮罩。具有任一指定屬性的目錄會包含在複製中。這等同於將
includeFileAttributes 套用至目錄。設定為 0 表示不依屬性篩選。
excludeDirectoryAttributes類型:uint32_t 推出版本: RIT 0.0.13-preview。 會使目錄從複製中排除的目錄屬性位元遮罩。這等同於將
excludeFileAttributes 套用至目錄。設定為 0 表示不依屬性篩選。
範例
下列名稱模式範例使用CopyTo。
只複製 .exe 和 .dll 檔案:
temp 的目錄:
當包含模式與排除模式衝突時,排除模式優先,檔案將不會被複製。
備註
透過searchOptions 參數將此結構傳遞給 WdRemoteCopy,以篩選要包含在複製作業中的檔案和目錄。如果為 searchOptions 傳遞 nullptr,則會複製所有檔案,不進行篩選。
變更歷程記錄
RIT 0.0.13-preview 的變更改變了結構配置。請使用相符 API NuGet 套件中的標頭和程式庫重新建置原生呼叫端;請勿將舊的結構配置傳遞給較新的 API DLL。
