WdCopySearchOptions

Specifies file and directory filter patterns for a copy operation. Introduced in: RIT 0.0.8-Preview. Member types and availability differ by release; see Change history.

For CopyFrom, name patterns affect local delta enumeration only; they do not restrict remote file selection.

Syntax

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

Members

_In_z_ includeFilePattern
Type: const char* A glob pattern specifying which files to include in the copy operation (for example, "*" to include all files, or "*.exe;*.dll" to include only executables and DLLs). _In_z_ excludeFilePattern
Type: const char* A glob pattern specifying which files to exclude from the copy operation (for example, "*.pdb" to exclude debug symbols). _In_z_ excludeDirPattern
Type: const char* A glob pattern specifying directory names, not paths, to exclude from the copy operation (for example, ".vs;obj" to exclude Visual Studio and build output directories). includeFileAttributes
Type: uint32_t A bitmask of file attributes. Files with any of the specified attributes are included in the copy. Set to 0 to not filter by attributes. For additional information on file attributes check File Attribute Constants. excludeFileAttributes
Type: uint32_t A bitmask of file attributes that cause files to be excluded from the copy. Set to 0 to not filter by attributes. For additional information on file attributes check File Attribute Constants. includeDirectoryAttributes
Type: uint32_t Introduced in: RIT 0.0.13-preview. A bitmask of directory attributes. Directories with any of the specified attributes are included in the copy. This is the same as includeFileAttributes applied to directories. Set to 0 to not filter by attributes. excludeDirectoryAttributes
Type: uint32_t Introduced in: RIT 0.0.13-preview. A bitmask of directory attributes that cause directories to be excluded from the copy. This is the same as excludeFileAttributes applied to directories. Set to 0 to not filter by attributes.

Examples

The name-pattern examples below use CopyTo. Copy only .exe and .dll files:

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

Exclude directories named temp from the copy:

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

Only copy read-only or system files, and exclude hidden files:

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

Only ignore hidden directories:

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

When there is a conflict between include and exclude patterns, the exclude pattern takes precedence and the file will not be copied.

Remarks

Pass this structure to WdRemoteCopy via the searchOptions parameter to filter which files and directories are included in the copy operation. If nullptr is passed for searchOptions, all files are copied with no filtering.

Change history

Release	Change
RIT 0.0.13-preview	Changed `includeFileAttributes` and `excludeFileAttributes` from `uint64_t` to `uint32_t`. Added `includeDirectoryAttributes` and `excludeDirectoryAttributes`, both `uint32_t`.
RIT 0.0.8-Preview	Introduced the three name-pattern fields and two `uint64_t` file-attribute masks.

The RIT 0.0.13-preview changes alter the structure layout. Rebuild native callers with the header and library from the matching API NuGet package; do not pass the older structure layout to the newer API DLL.

Requirements

Requirement	Value
Header	WdRemoteIteration.h
Library	wdremoteapi.lib
Supported OS	Windows 11 and later
Supported architectures	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

Syntax

Members

Examples

Remarks

Change history

Requirements

See also

​WdCopySearchOptions

​Syntax

​Members

​Examples

​Remarks

​Change history

​Requirements

​See also

WdCopySearchOptions

Syntax

Members

Examples

Remarks

Change history

Requirements

See also