IOfflineFilesEvents2
COM公式ドキュメント
オフラインファイルに関連する追加のイベントを報告するために使用します。
メソッド 9
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
Offline Files サービスが、すべてのオフラインスコープの再接続を試行し始めたことを報告します。
戻り値
戻り値は無視されます。
Offline Files サービスが、すべてのオフラインスコープの再接続の試行を完了したことを報告します。
戻り値
戻り値は無視されます。
このメソッドは将来の使用のために予約されています。(IOfflineFilesEvents2.CacheEvictBegin)
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
このメソッドは将来の使用のために予約されています。(IOfflineFilesEvents2.CacheEvictEnd)
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
Offline Files サービスがバックグラウンド同期パスの実行を開始したことを報告します。
| dwSyncControlFlags | DWORD | in | 同期操作の目的を表す 1 つ以上の OFFLINEFILES_SYNC_CONTROL_FLAG_XXXXXX フラグです。これらは、同期が一方向同期か双方向同期かを判別するために使用できます。これらのフラグは、IOfflineFilesCache::Synchronize メソッドの dwSyncControl パラメーターで説明されています。 |
戻り値
戻り値は無視されます。
Offline Files サービスがバックグラウンド同期パスを完了したことを報告します。
| dwSyncControlFlags | DWORD | in | 同期操作の目的を表す 1 つ以上の OFFLINEFILES_SYNC_CONTROL_FLAG_XXXXXX フラグです。これらは、同期が一方向同期か双方向同期かを判別するために使用できます。これらのフラグは、IOfflineFilesCache::Synchronize メソッドの dwSyncControl パラメーターで説明されています。 |
戻り値
戻り値は無視されます。
Offline Files サービスが、グループポリシーによって制御される設定値のうち 1 つ以上に変更を検出したことを報告します。
戻り値
戻り値は無視されます。
Offline Files サービスが、グループポリシーによって制御されない設定値のうち 1 つ以上に変更を検出したことを報告します。
戻り値
戻り値は無視されます。
Offline Files サービスが、グループポリシーまたはプリファレンス値で検出された変更を適用したことを報告します。
戻り値
戻り値は無視されます。
解説(Remarks)
Offline Files サービスは、グループポリシーまたはプリファレンス設定の変更を検出したことを報告した後、変更をシステムに適用してこのメソッドを呼び出すまで最大 5 秒間待機します。したがって、最後の PolicyChangeDetected イベントまたは PreferenceChangeDetected イベントから SettingsChangesApplied イベントまでに最大 5 秒が経過する可能性があります。イベントリスナーは、この時間間隔に基づいて何らかの仮定を行ったり、動作を実行したりすべきではありません。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IOfflineFilesEvents2 "{1EAD8F56-FF76-4FAA-A795-6F6EF792498B}"
#usecom global IOfflineFilesEvents2 IID_IOfflineFilesEvents2 "{}"
#comfunc global IOfflineFilesEvents2_ItemReconnectBegin 28
#comfunc global IOfflineFilesEvents2_ItemReconnectEnd 29
#comfunc global IOfflineFilesEvents2_CacheEvictBegin 30
#comfunc global IOfflineFilesEvents2_CacheEvictEnd 31
#comfunc global IOfflineFilesEvents2_BackgroundSyncBegin 32 int
#comfunc global IOfflineFilesEvents2_BackgroundSyncEnd 33 int
#comfunc global IOfflineFilesEvents2_PolicyChangeDetected 34
#comfunc global IOfflineFilesEvents2_PreferenceChangeDetected 35
#comfunc global IOfflineFilesEvents2_SettingsChangesApplied 36
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。