次の方法で共有

IVssFileShareSnapshotProvider::D eleteSnapshots メソッド (vsprov.h)

  • [アーティクル]

特定のスナップショット、または指定したスナップショット セット内のすべてのスナップショットを削除します。

構文

HRESULT DeleteSnapshots(
  [in]  VSS_ID          SourceObjectId,
  [in]  VSS_OBJECT_TYPE eSourceObjectType,
  [in]  BOOL            bForceDelete,
  [out] LONG            *plDeletedSnapshots,
  [out] VSS_ID          *pNondeletedSnapshotID
);

パラメーター

[in] SourceObjectId

削除するシャドウ コピーまたはシャドウ コピー セットの識別子。

[in] eSourceObjectType

削除するオブジェクトの型。 このパラメーターの値は、VSS_OBJECT_SNAPSHOTまたはVSS_OBJECT_SNAPSHOT_SETです。

[in] bForceDelete

このパラメーターの値が TRUE の場合、プロバイダーはシャドウ コピー セット内のシャドウ コピーまたはシャドウ コピーを削除するために可能なすべての処理を行います。 FALSE の場合、追加の作業は行われません。

[out] plDeletedSnapshots

削除されたシャドウ コピーの数を受け取る変数へのポインター。

[out] pNondeletedSnapshotID

エラーが発生した場合、このパラメーターは、削除できなかった最初のシャドウ コピーの識別子へのポインターを受け取ります。 それ以外の場合は、GUID_NULLを指します。

戻り値

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

値 意味
S_OK
 シャドウ コピーが正常に削除されました。
E_ACCESSDENIED
 呼び出し元が十分なバックアップ特権を持っていないか、管理者ではありません。
E_INVALIDARG
 パラメーター値の 1 つが無効です。
E_OUTOFMEMORY
 呼び出し元がメモリやその他のシステム リソースを使い切れている。
VSS_E_OBJECT_NOT_FOUND
 指定したシャドウ コピーが見つかりませんでした。
VSS_E_PROVIDER_VETO
 プロバイダー エラー。 プロバイダーがイベント ログにエラーを記録しました。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。

注釈

VSS コーディネーターは、スナップショット自動リリース プロセスの一環としてこのメソッドを呼び出します。 メソッドは、要求者主導の削除操作に応答して呼び出されます。

要件

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

こちらもご覧ください

IVssFileShareSnapshotProvider