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

IFhConfigMgr

COM
📘 Microsoft Learn (日本語) · English
IID6a5fea5b-bf8f-4ee5-b8c3-44d8a0d7331c継承元IUnknown自前メソッド開始 vtbl3

メソッド 14

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

vtbl 3 HRESULT LoadConfiguration()
vtbl 4 HRESULT CreateDefaultConfiguration(BOOL OverwriteIfExists)
OverwriteIfExistsBOOLin既存の構成が存在する場合に上書きするかどうかを指定するブール値である。
vtbl 5 HRESULT SaveConfiguration()
vtbl 6 HRESULT AddRemoveExcludeRule(BOOL Add, FH_PROTECTED_ITEM_CATEGORY Category, LPWSTR Item)
AddBOOLin規則を追加する場合は TRUE、削除する場合は FALSE を指定するブール値である。
CategoryFH_PROTECTED_ITEM_CATEGORYin規則の対象となる保護項目カテゴリ(FH_PROTECTED_ITEM_CATEGORY)を指定する。
ItemLPWSTRin対象となる項目(パスなど)を指定する文字列へのポインタである。
vtbl 7 HRESULT GetIncludeExcludeRules(BOOL Include, FH_PROTECTED_ITEM_CATEGORY Category, IFhScopeIterator** Iterator)
IncludeBOOLin包含規則を取得する場合は TRUE、除外規則を取得する場合は FALSE を指定するブール値である。
CategoryFH_PROTECTED_ITEM_CATEGORYin対象とする保護項目カテゴリ(FH_PROTECTED_ITEM_CATEGORY)を指定する。
IteratorIFhScopeIterator**out該当する規則を列挙する IFhScopeIterator を受け取るポインタである。
vtbl 8 HRESULT GetLocalPolicy(FH_LOCAL_POLICY_TYPE LocalPolicyType, ULONGLONG* PolicyValue)
LocalPolicyTypeFH_LOCAL_POLICY_TYPEin取得するローカルポリシーの種類(FH_LOCAL_POLICY_TYPE)を指定する。
PolicyValueULONGLONG*out指定したポリシーの値(ULONGLONG)を受け取るポインタである。
vtbl 9 HRESULT SetLocalPolicy(FH_LOCAL_POLICY_TYPE LocalPolicyType, ULONGLONG PolicyValue)
LocalPolicyTypeFH_LOCAL_POLICY_TYPEin設定するローカルポリシーの種類(FH_LOCAL_POLICY_TYPE)を指定する。
PolicyValueULONGLONGin設定するポリシーの値(ULONGLONG)を指定する。
vtbl 10 HRESULT GetBackupStatus(FH_BACKUP_STATUS* BackupStatus)
BackupStatusFH_BACKUP_STATUS*out現在のバックアップ状態(FH_BACKUP_STATUS)を受け取るポインタである。
vtbl 11 HRESULT SetBackupStatus(FH_BACKUP_STATUS BackupStatus)
BackupStatusFH_BACKUP_STATUSin設定するバックアップ状態(FH_BACKUP_STATUS)を指定する。
vtbl 12 HRESULT GetDefaultTarget(IFhTarget** DefaultTarget)
DefaultTargetIFhTarget**out既定のバックアップ先を表す IFhTarget インターフェイスを受け取るポインタである。
vtbl 13 HRESULT ValidateTarget(LPWSTR TargetUrl, FH_DEVICE_VALIDATION_RESULT* ValidationResult)
TargetUrlLPWSTRin検証する対象バックアップ先の URL を指定する文字列へのポインタである。
ValidationResultFH_DEVICE_VALIDATION_RESULT*out対象の検証結果(FH_DEVICE_VALIDATION_RESULT)を受け取るポインタである。
vtbl 14 HRESULT ProvisionAndSetNewTarget(LPWSTR TargetUrl, LPWSTR TargetName)
TargetUrlLPWSTRin新しいバックアップ先として設定する対象の URL を指定する文字列へのポインタである。
TargetNameLPWSTRin新しいバックアップ先に付ける表示名を指定する文字列へのポインタである。
vtbl 15 HRESULT ChangeDefaultTargetRecommendation(BOOL Recommend)
RecommendBOOLin既定の対象を推奨対象として設定するかどうかを指定するブール値である。
vtbl 16 HRESULT QueryProtectionStatus(DWORD* ProtectionState, LPWSTR* ProtectedUntilTime)
ProtectionStateDWORD*out現在の保護状態を表す値を受け取るポインタである。
ProtectedUntilTimeLPWSTR*out保護が有効な最終時刻を表す文字列を受け取るポインタである。

HSP用 COM定義

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

出力引数: 
#define global IID_IFhConfigMgr "{6A5FEA5B-BF8F-4EE5-B8C3-44D8A0D7331C}"
#usecom global IFhConfigMgr IID_IFhConfigMgr "{ED43BB3C-09E9-498A-9DF6-2177244C6DB4}"
#comfunc global IFhConfigMgr_LoadConfiguration                  3
#comfunc global IFhConfigMgr_CreateDefaultConfiguration         4 int
#comfunc global IFhConfigMgr_SaveConfiguration                  5
#comfunc global IFhConfigMgr_AddRemoveExcludeRule               6 int,int,wstr
#comfunc global IFhConfigMgr_GetIncludeExcludeRules             7 int,int,sptr
#comfunc global IFhConfigMgr_GetLocalPolicy                     8 int,var
#comfunc global IFhConfigMgr_SetLocalPolicy                     9 int,int64
#comfunc global IFhConfigMgr_GetBackupStatus                    10 var
#comfunc global IFhConfigMgr_SetBackupStatus                    11 int
#comfunc global IFhConfigMgr_GetDefaultTarget                   12 sptr
#comfunc global IFhConfigMgr_ValidateTarget                     13 wstr,var
#comfunc global IFhConfigMgr_ProvisionAndSetNewTarget           14 wstr,wstr
#comfunc global IFhConfigMgr_ChangeDefaultTargetRecommendation  15 int
#comfunc global IFhConfigMgr_QueryProtectionStatus              16 var,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。