IVssBackupComponents::SetContext メソッド (vsbackup.h)
SetContext メソッドは、後続のシャドウ コピー関連の操作のコンテキストを設定します。
構文
HRESULT SetContext(
[in] LONG lContext
);
パラメーター
[in] lContext
設定するコンテキスト。 コンテキストは、_VSS_SNAPSHOT_CONTEXTのサポートされている値のいずれか、または有効な_VSS_SNAPSHOT_CONTEXTを持つ_VSS_VOLUME_SNAPSHOT_ATTRIBUTESのサポートされているビット マスク (またはビットごとの OR) である必要があります。
戻り値
このメソッドの既定の戻り値はS_OK。 このメソッドの有効なリターン コードを次に示します。
| 値 | 説明 |
|---|---|
|
コンテキストを正常に設定しました。 |
|
パラメーター値の 1 つが無効です。 |
|
バックアップ コンポーネント オブジェクトが初期化されていないか、復元操作中にこのメソッドが呼び出されたか、このメソッドが正しいシーケンス内で呼び出されていません。 |
|
予期しないエラー。 エラー コードはエラー ログ ファイルに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。
Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 および Windows 7 まではサポートされません。 代わりに、E_UNEXPECTEDが使用されます。 |
解説
VSS シャドウ コピーの既定のコンテキストはVSS_CTX_BACKUP。
Windows XP: サポートされているコンテキストは、既定のコンテキストVSS_CTX_BACKUPのみです。 したがって、Windows XP で SetContext を 呼び出すと、E_NOTIMPLが返されます。
SetContext は 1 回だけ呼び出すことができます。ほとんどの VSS 関数を呼び出す前に呼び出す必要があります。
IVssBackupComponents::SetContext によって設定されたコンテキストがシャドウ コピーの作成と管理方法に与える影響の詳細については、「シャドウ コピーを作成するための実装の詳細」を参照してください。
許可されるシャドウ コピー コンテキストの詳細については、「 _VSS_SNAPSHOT_CONTEXT と _VSS_VOLUME_SNAPSHOT_ATTRIBUTES」を参照してください。
要件
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | vsbackup.h (VsBackup.h、Vss.h、VsWriter.h を含む) |
| Library | VssApi.lib |
関連項目
IVssBackupComponents::D oSnapshotSet