ホーム › Storage.Vss › IVssDifferentialSoftwareSnapshotMgmt2

IVssDifferentialSoftwareSnapshotMgmt2

COM

IID949d7353-675f-4275-8969-f044c6277815継承元IVssDifferentialSoftwareSnapshotMgmt自前メソッド開始 vtbl9

公式ドキュメント

システムシャドウコピープロバイダーが生成したシャドウコピー記憶域を、アプリケーションが問い合わせて管理できるようにする追加のメソッドを定義します。

メソッド 4

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 9 HRESULT ChangeDiffAreaMaximumSizeEx(WORD* pwszVolumeName, WORD* pwszDiffAreaVolumeName, LONGLONG llMaximumDiffSpace, BOOL bVolatile)

特定のボリュームのシャドウコピー記憶域の最大サイズを更新します。これはすぐに反映されるとは限りません。bVolatile パラメーターが FALSE の場合、この変更はコンピューターを再起動した後も維持されます。

pwszVolumeName	WORD*	in	シャドウコピーのソースとなるボリュームの名前です。このボリュームは、 pwszDiffAreaVolumeName ボリューム上のシャドウコピー記憶域に関連付けられています。ボリュームの名前は次のいずれかの形式で指定し、末尾に円記号 (\) を付ける必要があります。マウントされたフォルダーのパス (例: Y:\MountX\) ドライブ文字 (例: D:\) \\?\Volume{GUID}\ 形式のボリューム GUID パス (GUID はボリュームを識別します)
pwszDiffAreaVolumeName	WORD*	in	pwszVolumeName ボリュームに関連付けられたシャドウコピー記憶域を格納しているボリュームの名前です。ボリュームの名前は次のいずれかの形式で指定し、末尾に円記号 (\) を付ける必要があります。マウントされたフォルダーのパスドライブ文字 (例: D:\) \\?\Volume{GUID}\ 形式のボリューム GUID パス (GUID はボリュームを識別します)
llMaximumDiffSpace	LONGLONG	in	このボリューム用のシャドウコピー記憶域に使用する最大サイズをバイト単位で指定します。この値が 0 の場合、シャドウコピー記憶域は削除されます。この値が –1 の場合、最大サイズは無制限になります。
bVolatile	BOOL	in	ChangeDiffAreaMaximumSizeEx メソッドを呼び出した効果をコンピューターの再起動後に維持しない場合は TRUE、それ以外の場合は FALSE を指定します。既定値は FALSE です。 llMaximumDiffSpace パラメーターが 0 の場合、bVolatile パラメーターは FALSE でなければなりません。

戻り値

このメソッドは次のいずれかの値を返すことがあります。

値	意味
S_OK	シャドウコピー記憶域の最大サイズが正常に変更されました。
E_ACCESSDENIED	呼び出し元に十分なバックアップ特権がないか、呼び出し元が管理者ではありません。
E_INVALIDARG	いずれかのパラメーター値が有効ではありません。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。
VSS_E_INSUFFICIENT_STORAGE	pwszDiffAreaVolumeName ボリュームに十分な空き領域がありません。
VSS_E_OBJECT_NOT_FOUND	pwszVolumeName ボリュームと pwszDiffAreaVolumeName ボリュームの関連付けが見つかりませんでした。
VSS_E_PROVIDER_VETO	想定されるプロバイダーエラーが発生しました。エラーコードはイベントログに記録されます。詳細については、 VSS でのイベントとエラーの処理を参照してください。
VSS_E_UNEXPECTED	予期しないエラーです。エラーコードはエラーログファイルに記録されます。詳細については、 VSS でのイベントとエラーの処理を参照してください。 Windows Server 2008、Windows Vista、Windows Server 2003 および Windows XP: この値は Windows Server 2008 R2 および Windows 7 までサポートされません。代わりに E_UNEXPECTED が使用されます。
VSS_E_VOLUME_IN_USE	シャドウコピーが現在そのシャドウコピー記憶域を使用しています。

解説(Remarks)

ChangeDiffAreaMaximumSizeEx メソッドは、bVolatile パラメーターがある点を除いて IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize メソッドと同一です。

bVolatile パラメーターに FALSE を指定して ChangeDiffAreaMaximumSizeEx メソッドを呼び出すことは、ChangeDiffAreaMaximumSize メソッドを呼び出すことと同じです。

ChangeDiffAreaMaximumSizeEx はシャドウコピー記憶域を明示的なものにします。つまり、すべてのシャドウコピーが削除されても記憶域は自動的には削除されません。

シャドウコピー記憶域が存在しない場合、このメソッドはそれを作成します。

Windows Server 2008、Windows Vista および Windows Server 2003: シャドウコピー記憶域が存在しない場合でも、このメソッドはそれを作成しません。

シャドウコピー記憶域を作成するには、IVssDifferentialSoftwareSnapshotMgmt::AddDiffArea メソッドを使用します。

vtbl 10 HRESULT MigrateDiffAreas(WORD* pwszVolumeName, WORD* pwszDiffAreaVolumeName, WORD* pwszNewDiffAreaVolumeName)

このメソッドは将来の使用のために予約されています。(IVssDifferentialSoftwareSnapshotMgmt2.MigrateDiffAreas)

pwszVolumeName	WORD*	in	差分領域を移行する元ボリュームの名前を指定する文字列である。
pwszDiffAreaVolumeName	WORD*	in	現在差分領域が置かれているボリュームの名前を指定する文字列である。
pwszNewDiffAreaVolumeName	WORD*	in	差分領域の移行先ボリュームの名前を指定する文字列である。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 11 HRESULT QueryMigrationStatus(WORD* pwszVolumeName, WORD* pwszDiffAreaVolumeName, IVssAsync** ppAsync)

このメソッドは将来の使用のために予約されています。(IVssDifferentialSoftwareSnapshotMgmt2.QueryMigrationStatus)

pwszVolumeName	WORD*	in	移行状態を照会する元ボリュームの名前を指定する文字列である。
pwszDiffAreaVolumeName	WORD*	in	対象の差分領域ボリュームの名前を指定する文字列である。
ppAsync	IVssAsync**	out	移行状態の照会を制御・監視するための IVssAsync インターフェイスポインタを受け取るポインタへのポインタである。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 12 HRESULT SetSnapshotPriority(GUID idSnapshot, BYTE priority)

このメソッドは将来の使用のために予約されています。(IVssDifferentialSoftwareSnapshotMgmt2.SetSnapshotPriority)

idSnapshot	GUID	in	優先度を設定する対象スナップショットの識別子(GUID)を指定する。
priority	BYTE	in	スナップショットに設定する優先度の値を指定する。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数:

#define global IID_IVssDifferentialSoftwareSnapshotMgmt2 "{949D7353-675F-4275-8969-F044C6277815}"
#usecom global IVssDifferentialSoftwareSnapshotMgmt2 IID_IVssDifferentialSoftwareSnapshotMgmt2 "{}"
#comfunc global IVssDifferentialSoftwareSnapshotMgmt2_ChangeDiffAreaMaximumSizeEx  9 var,var,int64,int
#comfunc global IVssDifferentialSoftwareSnapshotMgmt2_MigrateDiffAreas             10 var,var,var
#comfunc global IVssDifferentialSoftwareSnapshotMgmt2_QueryMigrationStatus         11 var,var,sptr
#comfunc global IVssDifferentialSoftwareSnapshotMgmt2_SetSnapshotPriority          12 int,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IVssDifferentialSoftwareSnapshotMgmt2 "{949D7353-675F-4275-8969-F044C6277815}"
#usecom global IVssDifferentialSoftwareSnapshotMgmt2 IID_IVssDifferentialSoftwareSnapshotMgmt2 "{}"
#comfunc global IVssDifferentialSoftwareSnapshotMgmt2_ChangeDiffAreaMaximumSizeEx  9 sptr,sptr,int64,int
#comfunc global IVssDifferentialSoftwareSnapshotMgmt2_MigrateDiffAreas             10 sptr,sptr,sptr
#comfunc global IVssDifferentialSoftwareSnapshotMgmt2_QueryMigrationStatus         11 sptr,sptr,sptr
#comfunc global IVssDifferentialSoftwareSnapshotMgmt2_SetSnapshotPriority          12 int,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。