Win32 API 日本語リファレンス
ホーム › Storage.Vss › IVssCreateExpressWriterMetadata

IVssCreateExpressWriterMetadata

COM
📘 Microsoft Learn (日本語) · English
IID9c772e77-b26e-427f-92dd-c996f41ea5e3継承元IUnknown自前メソッド開始 vtbl3

メソッド 7

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

vtbl 3 HRESULT AddExcludeFiles(LPWSTR wszPath, LPWSTR wszFilespec, BYTE bRecursive)
wszPathLPWSTRinバックアップから除外するファイルが存在するパスを指定する。
wszFilespecLPWSTRin除外するファイル名のパターンを指定する。
bRecursiveBYTEin指定パス配下を再帰的に除外するかどうかを指定する。
vtbl 4 HRESULT AddComponent(VSS_COMPONENT_TYPE ct, LPWSTR wszLogicalPath, LPWSTR wszComponentName, LPWSTR wszCaption, BYTE* pbIcon, DWORD cbIcon, BYTE bRestoreMetadata, BYTE bNotifyOnBackupComplete, BYTE bSelectable, BYTE bSelectableForRestore, DWORD dwComponentFlags)
ctVSS_COMPONENT_TYPEin追加するコンポーネントの種別(データベースまたはファイルグループ)を示す列挙値を指定する。
wszLogicalPathLPWSTRinコンポーネントの論理パスを指定する。最上位の場合は NULL を指定できる。
wszComponentNameLPWSTRinコンポーネントの名前を指定する。
wszCaptionLPWSTRinコンポーネントの説明用キャプション文字列を指定する。
pbIconBYTE*inコンポーネントを表すアイコンのバイナリデータへのポインタである。アイコンがない場合は NULL を指定する。
cbIconDWORDinアイコンデータのバイト数を指定する。
bRestoreMetadataBYTEin復元時にメタデータの保存が必要かどうかを指定する。
bNotifyOnBackupCompleteBYTEinバックアップ完了時に通知を受けるかどうかを指定する。
bSelectableBYTEinバックアップ時にコンポーネント単位で選択可能かどうかを指定する。
bSelectableForRestoreBYTEin復元時にコンポーネント単位で選択可能かどうかを指定する。
dwComponentFlagsDWORDinコンポーネントの機能を示すフラグ(VSS_COMPONENT_FLAGS)の組み合わせを指定する。
vtbl 5 HRESULT AddFilesToFileGroup(LPWSTR wszLogicalPath, LPWSTR wszGroupName, LPWSTR wszPath, LPWSTR wszFilespec, BYTE bRecursive, LPWSTR wszAlternateLocation, DWORD dwBackupTypeMask)
wszLogicalPathLPWSTRin対象ファイルグループコンポーネントの論理パスを指定する。
wszGroupNameLPWSTRinファイルを追加するファイルグループの名前を指定する。
wszPathLPWSTRin追加するファイルが存在するパスを指定する。
wszFilespecLPWSTRin追加するファイル名のパターンを指定する。
bRecursiveBYTEin指定パス配下を再帰的に含めるかどうかを指定する。
wszAlternateLocationLPWSTRinファイルの代替格納場所のパスを指定する。代替場所がない場合は NULL を指定する。
dwBackupTypeMaskDWORDinこれらのファイルに適用されるバックアップ種別を示すマスクを指定する。
vtbl 6 HRESULT SetRestoreMethod(VSS_RESTOREMETHOD_ENUM method, LPWSTR wszService, LPWSTR wszUserProcedure, VSS_WRITERRESTORE_ENUM writerRestore, BYTE bRebootRequired)
methodVSS_RESTOREMETHOD_ENUMinファイルの復元方法を示す VSS_RESTOREMETHOD_ENUM 列挙値を指定する。
wszServiceLPWSTRin復元の前後に停止・再起動が必要なサービスの名前を指定する。該当しない場合は NULL を指定する。
wszUserProcedureLPWSTRinユーザーが参照すべき復元手順を記したドキュメントの場所を指定する。
writerRestoreVSS_WRITERRESTORE_ENUMin復元時にライターの関与が必要かどうかを示す VSS_WRITERRESTORE_ENUM 列挙値を指定する。
bRebootRequiredBYTEin復元を完了するために再起動が必要かどうかを指定する。
vtbl 7 HRESULT AddComponentDependency(LPWSTR wszForLogicalPath, LPWSTR wszForComponentName, GUID onWriterId, LPWSTR wszOnLogicalPath, LPWSTR wszOnComponentName)
wszForLogicalPathLPWSTRin依存関係を持つ側(依存元)コンポーネントの論理パスを指定する。
wszForComponentNameLPWSTRin依存元コンポーネントの名前を指定する。
onWriterIdGUIDin依存先ライターのクラス識別子(GUID)を指定する。
wszOnLogicalPathLPWSTRin依存先コンポーネントの論理パスを指定する。
wszOnComponentNameLPWSTRin依存先コンポーネントの名前を指定する。
vtbl 8 HRESULT SetBackupSchema(DWORD dwSchemaMask)
dwSchemaMaskDWORDinライターがサポートするバックアップスキーマ(VSS_BACKUP_SCHEMA)を示すマスクを指定する。
vtbl 9 HRESULT SaveAsXML(LPWSTR* pbstrXML)
pbstrXMLLPWSTR*outエクスプレスライターメタデータドキュメントを XML 文字列として受け取る文字列ポインタへのポインタである。

HSP用 COM定義

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

出力引数: 
#define global IID_IVssCreateExpressWriterMetadata "{9C772E77-B26E-427F-92DD-C996F41EA5E3}"
#usecom global IVssCreateExpressWriterMetadata IID_IVssCreateExpressWriterMetadata "{}"
#comfunc global IVssCreateExpressWriterMetadata_AddExcludeFiles         3 wstr,wstr,int
#comfunc global IVssCreateExpressWriterMetadata_AddComponent            4 int,wstr,wstr,wstr,var,int,int,int,int,int,int
#comfunc global IVssCreateExpressWriterMetadata_AddFilesToFileGroup     5 wstr,wstr,wstr,wstr,int,wstr,int
#comfunc global IVssCreateExpressWriterMetadata_SetRestoreMethod        6 int,wstr,wstr,int,int
#comfunc global IVssCreateExpressWriterMetadata_AddComponentDependency  7 wstr,wstr,int,wstr,wstr
#comfunc global IVssCreateExpressWriterMetadata_SetBackupSchema         8 int
#comfunc global IVssCreateExpressWriterMetadata_SaveAsXML               9 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。