IOfflineFilesSyncConflictHandler
COM公式ドキュメント
IOfflineFilesCache::Synchronize メソッドを呼び出すクライアントが、同期の競合が検出された際の競合解決方法を指定するために使用します。
メソッド 1
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
同期の競合に対する解決方法を提供します。
| pszPath | LPWSTR | in | 競合している項目の完全修飾 UNC パス。 |
| fStateKnown | DWORD | in | 同期状態がクライアントの状態、サーバーの状態、またはその両方のいずれに基づくものであるかを示します。このパラメーターには、次のフラグ値のいずれか、または両方を指定できます。 OFFLINEFILES_SYNC_STATE_LOCAL_KNOWN (0x00000001)同期状態はクライアントの状態に基づいています。 OFFLINEFILES_SYNC_STATE_REMOTE_KNOWN (0x00000002)同期状態はサーバーの状態に基づいています。 |
| state | OFFLINEFILES_SYNC_STATE | in | 競合している項目の状態を示す OFFLINEFILES_SYNC_STATE 列挙型の値。 |
| fChangeDetails | DWORD | in | state コードが項目の状態の変更を示している場合、この値はその変更をさらに詳しく示します。値は OFFLINEFILES_CHANGES_NONE (0x00000000)、または次のフラグ値の 1 つ以上になります。 OFFLINEFILES_CHANGES_LOCAL_SIZE (0x00000001)ローカルファイルのサイズが変更されました。 OFFLINEFILES_CHANGES_LOCAL_ATTRIBUTES (0x00000002)ローカルファイルの属性が変更されました。 OFFLINEFILES_CHANGES_LOCAL_TIME (0x00000004)ローカルファイルの変更時刻が変更されました。 OFFLINEFILES_CHANGES_REMOTE_SIZE (0x00000008)リモートファイルのサイズが変更されました。 OFFLINEFILES_CHANGES_REMOTE_ATTRIBUTES (0x00000010)リモートファイルの属性が変更されました。 OFFLINEFILES_CHANGES_REMOTE_TIME (0x00000020)リモートファイルの変更時刻が変更されました。 |
| pConflictResolution | OFFLINEFILES_SYNC_CONFLICT_RESOLVE* | out | 希望する解決コードを受け取ります。OFFLINEFILES_SYNC_CONFLICT_RESOLVE 列挙型の値を指定します。 |
| ppszNewName | LPWSTR* | out | pConflictResolution パラメーターの値が OFFLINEFILES_SYNC_CONFLICT_RESOLVE_KEEPALLCHANGES の場合、競合ハンドラーは項目の新しい名前を指定する必要があります。この新しい名前は、リモートおよびローカルに作成される新しいコピーに使用されます。これは完全修飾パスではなく、ファイル名である点に注意してください。 名前の文字列は CoTaskMemAlloc を使用して割り当てる必要があります。 解決方法で新しい名前が不要な場合、このパラメーターは NULL になることがあります。 同期センターで使用されるオフラインファイルの競合ハンドラーは、次の形式の名前を作成します。 <元の名前> (<ユーザー名> vN).<元の拡張子> ここで N はバージョン番号です。したがって、元のファイル名が "samples.doc" でユーザー名が "Alice" の場合、新しいファイル名は次のようになります。 "samples (Alice v1).doc" その名前のファイルが既に存在する場合、オフラインファイルの競合ハンドラーは一意の名前が見つかるまで N をインクリメントします。例:
|
戻り値
戻り値は無視されます。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IOfflineFilesSyncConflictHandler "{B6DD5092-C65C-46B6-97B8-FADD08E7E1BE}" #usecom global IOfflineFilesSyncConflictHandler IID_IOfflineFilesSyncConflictHandler "{}" #comfunc global IOfflineFilesSyncConflictHandler_ResolveConflict 3 wstr,int,int,int,var,var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IOfflineFilesSyncConflictHandler "{B6DD5092-C65C-46B6-97B8-FADD08E7E1BE}" #usecom global IOfflineFilesSyncConflictHandler IID_IOfflineFilesSyncConflictHandler "{}" #comfunc global IOfflineFilesSyncConflictHandler_ResolveConflict 3 wstr,int,int,int,sptr,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。