WdCopySearchOptions

복사 작업에 대한 파일 및 디렉터리 필터 패턴을 지정합니다. 도입된 릴리스: RIT 0.0.8-Preview. 멤버 형식과 가용성은 릴리스마다 다릅니다. 변경 기록을 참조하세요.

CopyFrom의 경우 이름 패턴은 로컬 델타 열거에만 영향을 주며, 원격 파일 선택을 제한하지 않습니다.

구문

struct WdCopySearchOptions 
{ 
    const char* includeFilePattern;
    const char* excludeFilePattern;
    const char* excludeDirPattern;
    uint32_t includeFileAttributes;
    uint32_t excludeFileAttributes;
    uint32_t includeDirectoryAttributes;
    uint32_t excludeDirectoryAttributes;
};

멤버

_In_z_ includeFilePattern
형식: const char* 복사 작업에 포함할 파일을 지정하는 glob 패턴입니다(예: 모든 파일을 포함하려면 "*", 실행 파일과 DLL만 포함하려면 "*.exe;*.dll"). _In_z_ excludeFilePattern
형식: const char* 복사 작업에서 제외할 파일을 지정하는 glob 패턴입니다(예: 디버그 기호를 제외하려면 "*.pdb"). _In_z_ excludeDirPattern
형식: const char* 복사 작업에서 제외할 디렉터리 이름(경로가 아님)을 지정하는 glob 패턴입니다(예: Visual Studio 및 빌드 출력 디렉터리를 제외하려면 ".vs;obj"). 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 파일만 복사:

WdCopySearchOptions searchOptions = {
    .includeFilePattern = "*.exe;*.dll",
    .excludeFilePattern = nullptr,
    .excludeDirPattern = nullptr,
    .includeFileAttributes = 0,
    .excludeFileAttributes = 0,
    .includeDirectoryAttributes = 0,
    .excludeDirectoryAttributes = 0
};

temp라는 이름의 디렉터리를 복사에서 제외:

WdCopySearchOptions searchOptions = {
    .includeFilePattern = nullptr,
    .excludeFilePattern = nullptr,
    .excludeDirPattern = "temp",
    .includeFileAttributes = 0,
    .excludeFileAttributes = 0,
    .includeDirectoryAttributes = 0,
    .excludeDirectoryAttributes = 0
};

읽기 전용 또는 시스템 파일만 복사하고 숨김 파일은 제외:

WdCopySearchOptions searchOptions = {
    .includeFilePattern = nullptr,
    .excludeFilePattern = nullptr,
    .excludeDirPattern = nullptr,
    .includeFileAttributes = FILE_ATTRIBUTE_READONLY | FILE_ATTRIBUTE_SYSTEM,
    .excludeFileAttributes = FILE_ATTRIBUTE_HIDDEN,
    .includeDirectoryAttributes = 0,
    .excludeDirectoryAttributes = 0
};

숨김 디렉터리만 무시:

WdCopySearchOptions searchOptions = {
    .includeFilePattern = nullptr,
    .excludeFilePattern = nullptr,
    .excludeDirPattern = nullptr,
    .includeFileAttributes = 0,
    .excludeFileAttributes = 0,
    .includeDirectoryAttributes = 0,
    .excludeDirectoryAttributes = FILE_ATTRIBUTE_HIDDEN
};

포함 패턴과 제외 패턴이 충돌하는 경우 제외 패턴이 우선하며 해당 파일은 복사되지 않습니다.

설명

이 구조체를 searchOptions 매개 변수를 통해 WdRemoteCopy에 전달하여 복사 작업에 포함할 파일과 디렉터리를 필터링합니다. searchOptions에 nullptr을 전달하면 필터링 없이 모든 파일이 복사됩니다.

변경 기록

릴리스	변경 내용
RIT 0.0.13-preview	`includeFileAttributes` 및 `excludeFileAttributes`를 `uint64_t`에서 `uint32_t`로 변경했습니다. `includeDirectoryAttributes` 및 `excludeDirectoryAttributes`(둘 다 `uint32_t`)를 추가했습니다.
RIT 0.0.8-Preview	세 개의 이름 패턴 필드와 두 개의 `uint64_t` 파일 특성 마스크를 도입했습니다.

RIT 0.0.13-preview 변경 내용은 구조체 레이아웃을 변경합니다. 일치하는 API NuGet 패키지의 헤더와 라이브러리로 네이티브 호출자를 다시 빌드하고, 이전 구조체 레이아웃을 최신 API DLL에 전달하지 마세요.

요구 사항

요구 사항	값
헤더	WdRemoteIteration.h
라이브러리	wdremoteapi.lib
지원 OS	Windows 11 이상
지원 아키텍처	x64, ARM64

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

WdCopySearchOptions

WdCopySearchOptions

구문

멤버

예제

설명

변경 기록

요구 사항

함께 보기

​WdCopySearchOptions

​구문

​멤버

​예제

​설명

​변경 기록

​요구 사항

​함께 보기

WdCopySearchOptions

구문

멤버

예제

설명

변경 기록

요구 사항

함께 보기