IVssCreateExpressWriterMetadata::AddExcludeFiles メソッド (vswriter.h)
高速ライターのコンポーネントがバックアップされるときに暗黙的に含まれる可能性があるファイル セット (指定されたファイル) を除外します。
構文
HRESULT AddExcludeFiles(
[in] LPCWSTR wszPath,
[in] LPCWSTR wszFilespec,
[in] bool bRecursive
);
パラメーター
[in] wszPath
ファイルを除外するルート ディレクトリを含む null で終わるワイド文字列へのポインター。
パスには環境変数 (%SystemRoot%) を含めることができますが、ワイルドカード文字を含めることはできません。
パスが円記号 (\) で終わるという要件はありません。 この情報をチェックに取得するのはアプリケーションです。
[in] wszFilespec
除外するファイルのファイル指定を含む null で終わるワイド文字列へのポインター。
ファイル指定にディレクトリ指定を含めることはできません (たとえば、円記号は含めません)。ただし、 を含めることができます。 および * ワイルドカード文字。
[in] bRecursive
wszPath パラメーターで指定されたパスが 1 つのディレクトリのみを識別するか、再帰的に走査するディレクトリの階層を示すかどうかを指定するブール値。 パスが繰り返されるディレクトリの階層として扱われる場合は true 、それ以外の場合は false に設定する必要があります。
マウントされたフォルダーの走査の詳細については、「マウント されたフォルダーの操作」および「ポイントの再解析」を参照してください。
戻り値
このメソッドの有効なリターン コードを次に示します。
| 値 | 意味 |
|---|---|
|
操作に成功しました。 |
|
パラメーター値の 1 つが無効です。 |
|
呼び出し元がメモリ不足またはその他のシステム リソースです。 |
|
XML ドキュメントが無効です。 詳細については、イベント ログを確認してください。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。 |
|
予期しないエラー。 エラー コードはエラー ログ ファイルに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。
Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 および Windows 7 まではサポートされません。 代わりに、E_UNEXPECTEDが使用されます。 |
注釈
Express ライターはローカル リソースのみをサポートします。絶対パスが有効なローカル ボリューム仕様で始まり、マップされたネットワーク ドライブにすることはできません。 したがって、AddExcludeFiles へのパス入力 (wszPath) は (環境変数の解決後に) この形式である必要があります。 たとえば、多くの場合、コンポーネントを定義して指定したディレクトリ内のすべてのファイルを含め、 AddExcludeFiles を使用して一部のファイル (一時ファイルなど) をバックアップから明示的に削除すると便利です。
ファイルの除外の詳細については、「ファイル 一覧の指定を除外する」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | vswriter.h (Vss.h、VsWriter.h を含む) |
| Library | VssApi.lib |