메인 콘텐츠로 건너뛰기

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로 설정되어 있더라도 루트 폴더는 유지됩니다.

요구 사항

함께 보기

마지막 수정일 2026년 10월 6일