IVssProviderCreateSnapshotSet::P reFinalCommitSnapshots メソッド (vsprov.h)

  • [アーティクル]

PreFinalCommitSnapshots メソッドを使用すると、プロバイダーはシャドウ コピーの自動回復をサポートできます。 シャドウ コピーの コンテキストでVSS_VOLSNAP_ATTR_AUTORECOVER フラグが設定されている場合、ボリュームは自動回復操作中に多数の書き込みを受け取ることができます。

構文

HRESULT PreFinalCommitSnapshots(
  [in] VSS_ID SnapshotSetId
);

パラメーター

[in] SnapshotSetId

シャドウ コピー セットを識別する VSS_ID 。

戻り値

リターン コード/値 Description
S_OK
0x000000000L
 操作が正常に完了しました。
E_OUTOFMEMORY
0x8007000EL
 メモリ不足またはその他のシステム リソース。
E_INVALIDARG
0x80070057L
 パラメーター値の 1 つが無効です。
VSS_E_PROVIDER_VETO
0x80042306L
 予期しないプロバイダー エラーが発生しました。 これが返された場合は、アプリケーション イベント ログのエントリでエラーを記述し、問題を解決する方法に関する情報をユーザーに提供する必要があります。
 

他の値が返された場合、VSS はイベント ログにイベントを書き込み、エラーを VSS_E_UNEXPECTED_PROVIDER_ERRORに変換します。

注釈

このメソッドは、Windows Server 2003 Service Pack 1 (SP1) で 自動回復 機能が導入されたときにバイナリ互換性を有効にするために追加されました。

メモ Windows Server 2003 の場合、ハードウェア プロバイダーは、次の例を使用してこのメソッドを実装することをお勧めします。
 
HRESULT PreFinalCommitSnapshots(
VSS_ID     /* SnapshotSetId */
)
{
    return S_OK;
}

要件

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

こちらもご覧ください

IVssProviderCreateSnapshotSet