IVssExamineWriterMetadataEx2::GetExcludeFromSnapshotFile メソッド (vsbackup.h)

  • [アーティクル]

特定のシャドウ コピーから明示的に除外された ファイル セット に関する情報を取得します。

構文

HRESULT GetExcludeFromSnapshotFile(
  [in]  UINT           iFile,
  [out] IVssWMFiledesc **ppFiledesc
);

パラメーター

[in] iFile

除外された ファイル セットのインデックス。 このパラメーターの値は、0 から n から 1 までの整数です。 n は、特定のシャドウ コピーから明示的に除外された ファイル セット の合計数です。 n の値は、IVssExamineWriterMetadataEx2::GetExcludeFromSnapshotCount メソッドによって返されます。

[out] ppFiledesc

ファイル要素情報を含む IVssWMFiledesc オブジェクトへの二重間接ポインター。

戻り値

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

値 意味
S_OK
 IVssWMFiledesc インターフェイスへのポインターが正常に返されました。
E_INVALIDARG
 パラメーター値の 1 つが無効です。
E_OUTOFMEMORY
 呼び出し元がメモリやその他のシステム リソースを使い切れている。
VSS_E_UNEXPECTED
 予期しないエラー。 エラー コードは、エラー ログ ファイルに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。

Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 と Windows 7 まではサポートされません。 代わりに E_UNEXPECTED が使用されます。

注釈

呼び出し元は、 IUnknown::Release メソッドを呼び出して、返された IVssWMFiledesc オブジェクトのリソースを解放します。

GetExcludeFromSnapshotFile メソッドは、シャドウ コピーから除外されたファイル セットに関する情報を報告することを目的としています。 要求者は、このメソッドによって返される情報に基づいて、バックアップからファイルを除外しないでください。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー vsbackup.h (VsBackup.h、Vss.h、VsWriter.h を含む)
Library VssApi.lib

こちらもご覧ください

IVssCreateWriterMetadataEx::AddExcludeFilesFromSnapshot

IVssExamineWriterMetadataEx2

IVssExamineWriterMetadataEx2::GetExcludeFromSnapshotCount