ホーム › 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	想定されるプロバイダーエラーが発生しました。エラーコードはイベントログに記録されます。詳細については、 Event and Error Handling Under VSS を参照してください。
VSS_E_UNEXPECTED	予期しないエラーです。エラーコードはエラーログファイルに記録されます。詳細については、 Event and Error Handling Under 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 指定が可能。