次の方法で共有

IVssSoftwareSnapshotProvider::SetContext メソッド (vsprov.h)

  • [アーティクル]

後続のシャドウ コピー関連の操作のコンテキストを設定します。

構文

HRESULT SetContext(
  [in] LONG lContext
);

パラメーター

[in] lContext

設定するコンテキスト。 コンテキストは、_VSS_SNAPSHOT_CONTEXTのサポートされている値のいずれか、または_VSS_VOLUME_SNAPSHOT_ATTRIBUTES値と_VSS_SNAPSHOT_CONTEXT値のサポートされている組み合わせである必要があります。

戻り値

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

値 意味
S_OK
 コンテキストが正常に設定されました。
E_ACCESSDENIED
 呼び出し元が十分なバックアップ特権を持っていないか、管理者ではありません。
E_INVALIDARG
 パラメーター値の 1 つが無効です。
E_OUTOFMEMORY
 呼び出し元がメモリやその他のシステム リソースを使い切れている。
VSS_E_BAD_STATE
 コンテキストは固定されており、変更できません。

注釈

VSS シャドウ コピーの既定のコンテキストはVSS_CTX_BACKUP。

Windows XP: サポートされているコンテキストは、既定のコンテキストVSS_CTX_BACKUPのみです。 したがって、Windows XP で SetContext を 呼び出すと、E_NOTIMPLが返されます。

SetContext によって設定されるコンテキストがシャドウ コピーの作成と管理方法にどのように影響するかの詳細については、「シャドウ コピーの作成に関する実装の詳細」を参照してください。

許可されるシャドウ コピー コンテキストの詳細については、「 _VSS_SNAPSHOT_CONTEXT と _VSS_VOLUME_SNAPSHOT_ATTRIBUTES」を参照してください。

要件

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

こちらもご覧ください

IVssSoftwareSnapshotProvider