Skip to main content

WdDeleteSearchOptions

指定刪除作業的檔案與目錄篩選模式。 推出版本: RIT 0.0.13-preview。

語法

成員

includeFilePattern
類型:const char*
包含符合指定名稱的檔案。支援萬用字元 * 和 ?,多個模式可以使用分號 (;) 分隔。預設值為 nullptr,表示包含所有項目。 excludeFilePattern
類型:const char*
排除符合指定名稱的檔案。支援萬用字元 * 和 ?,多個模式可以使用分號 (;) 分隔。預設值為 nullptr,表示不排除任何檔案。 excludeDirPattern
類型:const char*
排除符合指定名稱 (而非路徑) 的目錄。支援萬用字元 * 和 ?。預設值為 nullptr,表示不會將任何目錄排除在刪除範圍之外。 includeFileAttributes
類型:uint64_t
包含已設定任一指定檔案屬性的檔案。支援的值為 FILE_ATTRIBUTE_READONLY、FILE_ATTRIBUTE_ARCHIVE、FILE_ATTRIBUTE_SYSTEM 和 FILE_ATTRIBUTE_HIDDEN。預設值為 0,表示包含所有屬性。如需檔案屬性的其他資訊,請參閱檔案屬性常數。 excludeFileAttributes
類型:uint64_t
排除已設定任一指定檔案屬性的檔案。支援的值為 FILE_ATTRIBUTE_READONLY、FILE_ATTRIBUTE_ARCHIVE、FILE_ATTRIBUTE_SYSTEM 和 FILE_ATTRIBUTE_HIDDEN。預設值為 0,表示不排除任何屬性。如需檔案屬性的其他資訊,請參閱檔案屬性常數。 includeDirAttributes
類型:uint64_t
包含已設定任一指定檔案屬性的目錄。支援的值為 FILE_ATTRIBUTE_READONLY、FILE_ATTRIBUTE_ARCHIVE、FILE_ATTRIBUTE_SYSTEM 和 FILE_ATTRIBUTE_HIDDEN。預設值為 0,表示包含所有屬性。 excludeDirAttributes
類型:uint64_t
排除已設定任一指定檔案屬性的目錄。支援的值為 FILE_ATTRIBUTE_READONLY、FILE_ATTRIBUTE_ARCHIVE、FILE_ATTRIBUTE_SYSTEM 和 FILE_ATTRIBUTE_HIDDEN。預設值為 0,表示不排除任何屬性。

範例

只刪除 .pdb 和 .log 檔案:
刪除儲存資料目錄以外的所有項目:
刪除已封存的檔案,但保留唯讀檔案和隱藏目錄:
[!NOTE]
當包含與排除模式之間發生衝突時,排除模式優先,該項目不會被刪除。

備註

透過 searchOptions 參數將此結構傳遞給 WdDeleteRemoteFiles,以篩選要選取刪除的檔案與目錄。如果為 searchOptions 傳遞 nullptr,則會包含所有項目,不進行任何篩選。 這些選項只在 remoteFolderPath 解析為資料夾時適用。當 remoteFolderPath 解析為單一檔案時,會忽略這些選項。 即使在 WdDeleteOptions 中將 deleteRootFolder 設為 true,留下部分項目的篩選刪除仍會保留根資料夾,因為只有在資料夾已清空時才會移除該資料夾。

需求

另請參閱

Last modified on October 6, 2026