次の方法で共有

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

  • [アーティクル]

VSS は、シャドウ コピー セットに追加されるシャドウ コピーごとにこのメソッドを呼び出します。

構文

HRESULT BeginPrepareSnapshot(
  [in] VSS_ID   SnapshotSetId,
  [in] VSS_ID   SnapshotId,
  [in] VSS_PWSZ pwszVolumeName,
  [in] LONG     lNewContext
);

パラメーター

[in] SnapshotSetId

シャドウ コピー セット識別子。

[in] SnapshotId

作成するシャドウ コピーの識別子。

[in] pwszVolumeName

ボリューム名を含む Null で終わるワイド文字列。 名前は次のいずれかの形式で、末尾に円記号 (\) を含める必要があります。

  • マウントされたフォルダーのパス (Y:\MountX\ など)
  • ドライブ文字 (D:\ など)
  • \\?\Volume{GUID}\ という形式のボリューム GUID パス ( GUID はボリュームを識別します)

[in] lNewContext

シャドウ コピー セットのコンテキスト。 このコンテキストは、 _VSS_VOLUME_SNAPSHOT_ATTRIBUTES 値のビットマスクで構成されます。

戻り値

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

値 意味
S_OK
 シャドウ コピーが正常に作成されました。
E_ACCESSDENIED
 呼び出し元に十分なバックアップ特権がないか、管理者ではありません。
E_INVALIDARG
 パラメーター値の 1 つが無効です。
E_OUTOFMEMORY
 呼び出し元がメモリ不足またはその他のシステム リソースです。
VSS_E_OBJECT_NOT_FOUND
 指定されたボリュームが見つかりませんでした。
VSS_E_PROVIDER_VETO
 プロバイダー エラー。 プロバイダーは、イベント ログにエラーを記録しました。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。
VSS_E_UNSUPPORTED_CONTEXT
 指定されたコンテキストはサポートされていません。
VSS_E_VOLUME_NOT_SUPPORTED_BY_PROVIDER
 プロバイダーは、指定されたボリュームをサポートしていません。
VSS_E_UNEXPECTED
 予期しないエラー。 エラー コードはエラー ログ ファイルに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。

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

要件

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

こちらもご覧ください

IVssSoftwareSnapshotProvider