IVssCreateWriterMetadataEx::AddExcludeFilesFromSnapshot メソッド (vswriter.h)
シャドウ コピーの作成時にライターによって明示的に除外される ファイル セット を報告します。
このメソッドを呼び出しても、ファイルは除外されません。 ライターは、 CSVsWriter::OnPostSnapshot メソッドのシャドウ コピーからファイルを削除する必要があります。
構文
HRESULT AddExcludeFilesFromSnapshot(
[in] LPCWSTR wszPath,
[in] LPCWSTR wszFilespec,
[in] bool bRecursive
);
パラメーター
[in] wszPath
ファイルを除外するルート ディレクトリを含む null で終わるワイド文字列へのポインター。
ディレクトリは VSS マシン上のローカル ディレクトリにすることも、リモート ファイル サーバー上のファイル共有ディレクトリにすることもできます。
UNC パスがサポートされています。
パスには環境変数 (%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が使用されます。 |
注釈
Windows 7、Windows Server 2008 R2、Windows Vista、Windows Server 2008、Windows XP、Windows Server 2003: リモート ファイル共有は、Windows 8してWindows Server 2012するまでサポートされません。
AddExcludeFilesFromSnapshot メソッドの使用は省略可能です。 ライターは、シャドウ コピー操作の間で大幅に変更される大きなファイルに対してのみ、このメソッドを使用する必要があります。
このメソッドは、 IVssCreateWriterMetadata::AddExcludeFiles メソッドに 代わるものではありません。 ライターは AddExcludeFiles メソッドを引き続き使用して、バックアップから除外される ファイル セット を報告する必要があります。
呼び出し元は、 IUnknown::Release メソッドを呼び出して、返された IVssWMFiledesc オブジェクトのリソースを解放する役割を担います。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | vswriter.h (Vss.h、VsWriter.h を含む) |
| Library | VssApi.lib |
こちらもご覧ください
IVssCreateWriterMetadata::AddExcludeFiles