WdCopySearchOptions

コピー操作のファイルおよびディレクトリのフィルターパターンを指定します。

構文

struct WdCopySearchOptions 
{ 
    const char* includeFilePattern;
    const char* excludeFilePattern;
    const char* excludeDirPattern;
    uint64_t includeFileAttributes;
    uint64_t excludeFileAttributes;
};

メンバー

_In_z_ includeFilePattern
Type: const char* コピー操作に含めるファイルを指定する glob パターン (例: すべてのファイルを含めるには "*"、実行可能ファイルと DLL のみを含めるには "*.exe;*.dll")。 _In_z_ excludeFilePattern
Type: const char* コピー操作から除外するファイルを指定する glob パターン (例: デバッグシンボルを除外するには "*.pdb")。 _In_z_ excludeDirPattern
Type: const char* コピー操作から除外するディレクトリを指定する glob パターン (例: Visual Studio とビルド出力のディレクトリを除外するには ".vs;obj")。 includeFileAttributes
Type: uint64_t コピーに含めるためにファイルが持つ必要のあるファイル属性のビットマスク。属性でフィルタリングしない場合は 0 に設定します。ファイル属性の詳細については、ファイル属性定数を参照してください。 excludeFileAttributes
Type: uint64_t コピーからファイルを除外させるファイル属性のビットマスク。属性でフィルタリングしない場合は 0 に設定します。ファイル属性の詳細については、ファイル属性定数を参照してください。

例

.exe と .dll ファイルのみをコピーする:

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

コピーから temp という名前のディレクトリを除外する:

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

読み取り専用ファイルまたはシステムファイルのみをコピーし、隠しファイルを除外する:

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

包含パターンと除外パターンが競合する場合、除外パターンが優先され、そのファイルはコピーされません。

解説

コピー操作に含めるファイルとディレクトリをフィルタリングするには、searchOptions パラメーターを介してこの構造体を WdRemoteCopy に渡します。searchOptions に nullptr を渡した場合、フィルタリングなしですべてのファイルがコピーされます。

要件

要件	値
ヘッダー	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

構文

メンバー

例

解説

要件

関連項目