ホーム › System.ServerBackup › IWsbApplicationBackupSupport
IWsbApplicationBackupSupport
COM公式ドキュメント
アプリケーションの VSS ライターのコンポーネントの整合性をチェックするメソッドを定義します。
メソッド 1
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
vtbl 3 HRESULT CheckConsistency(LPWSTR wszWriterMetadata, LPWSTR wszComponentName, LPWSTR wszComponentLogicalPath, DWORD cVolumes, LPWSTR* rgwszSourceVolumePath, LPWSTR* rgwszSnapshotVolumePath, IWsbApplicationAsync** ppAsync)
バックアップ対象のボリュームに対してシャドウコピーが作成された後、シャドウコピー内の VSS ライターのコンポーネントの整合性をチェックします。
| wszWriterMetadata | LPWSTR | in | VSS ライターのメタデータを含む文字列。 |
| wszComponentName | LPWSTR | in | チェックするコンポーネントまたはコンポーネントセットの名前。wszWriterMetadata パラメーターが指すメタデータ内の名前と一致する必要があります。 |
| wszComponentLogicalPath | LPWSTR | in | チェックするコンポーネントまたはコンポーネントセットの論理パス。wszWriterMetadata パラメーターが指すメタデータ内の論理パスと一致する必要があります。 |
| cVolumes | DWORD | in | シャドウコピーボリュームの数。このパラメーターの値は 0 から MAX_VOLUMES までの範囲を取ることができます。 |
| rgwszSourceVolumePath | LPWSTR* | in | ソースボリュームごとに 1 つずつのボリューム GUID パスの配列へのポインター。ボリューム GUID パスの形式は "\?\Volume{GUID}" です。 |
| rgwszSnapshotVolumePath | LPWSTR* | in | シャドウコピーボリュームごとに 1 つずつのボリューム GUID パスの配列へのポインター。整合性チェックはこれらのボリュームに対して実行されます。 |
| ppAsync | IWsbApplicationAsync** | out | 整合性チェック操作のステータスを取得するために使用できる IWsbApplicationAsync インターフェイスポインターを受け取る変数へのポインター。整合性チェックが不要な場合、このポインターは NULL にすることができます。整合性チェック操作が完了したら、IWsbApplicationAsync オブジェクトが保持するすべてのリソースを解放するために IUnknown::Release メソッドを呼び出す必要があります。 |
戻り値
成功した場合は S_OK を返し、それ以外の場合はエラー値を返します。返される可能性のある値には以下が含まれます。
解説(Remarks)
整合性チェックは長時間実行される操作になる可能性があるため、アプリケーションは非同期操作として実行する必要があります。アプリケーションは、シャドウコピー内の VSS ライターのコンポーネントのファイルの整合性をチェックする必要があります。これらのファイルは、バックアップ操作の一部としてバックアップされます。整合性チェックが失敗した場合でも、コンポーネントのバックアップ自体は成功しますが、結果として得られるバックアップセットからのコンポーネントの復元は許可されません。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
出力引数:
#define global IID_IWsbApplicationBackupSupport "{1EFF3510-4A27-46AD-B9E0-08332F0F4F6D}" #usecom global IWsbApplicationBackupSupport IID_IWsbApplicationBackupSupport "{}" #comfunc global IWsbApplicationBackupSupport_CheckConsistency 3 wstr,wstr,wstr,int,var,var,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IWsbApplicationBackupSupport "{1EFF3510-4A27-46AD-B9E0-08332F0F4F6D}" #usecom global IWsbApplicationBackupSupport IID_IWsbApplicationBackupSupport "{}" #comfunc global IWsbApplicationBackupSupport_CheckConsistency 3 wstr,wstr,wstr,int,sptr,sptr,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。