IVssExamineWriterMetadataEx2::GetExcludeFromSnapshotFile メソッド (vsbackup.h)
特定のシャドウ コピーから明示的に除外された ファイル セット に関する情報を取得します。
構文
HRESULT GetExcludeFromSnapshotFile(
[in] UINT iFile,
[out] IVssWMFiledesc **ppFiledesc
);
パラメーター
[in] iFile
除外された ファイル セットのインデックス。 このパラメーターの値は、0 から n から 1 までの整数です。 n は、特定のシャドウ コピーから明示的に除外された ファイル セット の合計数です。 n の値は、IVssExamineWriterMetadataEx2::GetExcludeFromSnapshotCount メソッドによって返されます。
[out] ppFiledesc
ファイル要素情報を含む IVssWMFiledesc オブジェクトへの二重間接ポインター。
戻り値
このメソッドの有効なリターン コードを次に示します。
| 値 | 意味 |
|---|---|
|
IVssWMFiledesc インターフェイスへのポインターが正常に返されました。 |
|
パラメーター値の 1 つが無効です。 |
|
呼び出し元がメモリやその他のシステム リソースを使い切れている。 |
|
予期しないエラー。 エラー コードは、エラー ログ ファイルに記録されます。 詳細については、「 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 |