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 に設定する必要があります。

マウントされたフォルダーの走査の詳細については、「マウント されたフォルダーの操作」および「ポイントの再解析」を参照してください。

戻り値

このメソッドの有効なリターン コードを次に示します。

値 意味
S_OK
0x000000000L
 操作に成功しました。
E_INVALIDARG
0x80070057L
 パラメーター値の 1 つが無効です。
E_OUTOFMEMORY
0x8007000EL
 呼び出し元がメモリ不足またはその他のシステム リソースです。
VSS_E_INVALID_XML_DOCUMENT
0x80042311L
 XML ドキュメントが無効です。 詳細については、イベント ログを確認してください。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。
VSS_E_NOT_SUPPORTED
0x8004232FL
 このメソッドは、高速ライターではサポートされていません。
VSS_E_UNEXPECTED
 予期しないエラー。 エラー コードはエラー ログ ファイルに記録されます。 詳細については、「 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

IVssCreateWriterMetadataEx

IVssExamineWriterMetadataEx2::GetExcludeFromSnapshotCount

IVssExamineWriterMetadataEx2::GetExcludeFromSnapshotFile