ISyncMgrResolutionHandler
COM公式ドキュメント
同期の競合を管理するメソッドを公開します。同期の競合ハンドラーを作成するには、このインターフェイスを実装します。競合解決ユーザーインターフェイス (UI) は、ユーザーに提示された競合を解決するためにこのインターフェイスを呼び出します。
メソッド 5
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
競合の提示側が表示する選択肢を決定します。
| pdwAbilities | DWORD* | out | このメソッドが返るとき、SYNCMGR_RESOLUTION_ABILITIES 列挙型のいずれかの値が格納されます。 |
戻り値
型: HRESULT
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
ハンドラーは、このメソッドを呼び出すことで競合をどのように解決できるかを公開します。このメソッドの結果により、競合の提示側が表示する選択肢が決まり、その結果として、このインターフェイスの他のメソッドがどのように呼び出されるかが決まります。
競合しているバージョンを、通常は元のバージョンをマージした別の Shell アイテムで置き換えます。
| psiOther | IShellItem* | in | 置き換え先となる IShellItem へのポインター。 |
| pFeedback | SYNCMGR_RESOLUTION_FEEDBACK* | out | このメソッドが返るとき、SYNCMGR_RESOLUTION_FEEDBACK 値が格納されます。 |
戻り値
型: HRESULT
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
競合している Shell アイテムを置き換える指定の Shell アイテムは、元々競合していたもののいずれかである必要はありません。マージされたコピーであっても、置き換え用のコピーであってもかまいません。
pFeedback に返される SYNCMGR_RESOLUTION_FEEDBACK 値によって、次の競合をどのように解決するかが決まります。このメソッドが失敗した場合は、エラーメッセージが表示され、どのように処理を進めるかがユーザーに問い合わされます。
より新しいコピーを保持します。
| pFeedback | SYNCMGR_RESOLUTION_FEEDBACK* | out | このメソッドが返るとき、SYNCMGR_RESOLUTION_FEEDBACK 値が格納されます。 |
戻り値
型: HRESULT
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
競合を削除し、IShellItem を同期対象から除外します。
| pFeedback | SYNCMGR_RESOLUTION_FEEDBACK* | out | SYNCMGR_RESOLUTION_FEEDBACK 値へのポインター。 |
戻り値
型: HRESULT
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
競合している IShellItem は以降同期されなくなり、競合は削除されます。
pFeedback に返される SYNCMGR_RESOLUTION_FEEDBACK 値によって、次の競合をどのように解決するかが決まります。このメソッドが失敗した場合は、エラーメッセージが表示され、どのように処理を進めるかがユーザーに問い合わされます。
渡された Shell アイテムを保持します。
| pArray | ISyncMgrConflictResolutionItems* | in | ISyncMgrConflictResolutionItems の配列へのポインター。ISyncMgrResolutionHandler::QueryAbilities メソッドがパラメーター pdwAbilities に SYNCMGR_RA_KEEP_MULTIPLE を返した場合、この配列には複数のアイテムが含まれます。 |
| pFeedback | SYNCMGR_RESOLUTION_FEEDBACK* | out | このメソッドが返るとき、SYNCMGR_RESOLUTION_FEEDBACK 値が格納されます。 |
戻り値
型: HRESULT
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
pFeedback に返される SYNCMGR_RESOLUTION_FEEDBACK 値によって、次の競合をどのように解決するかが決まります。このメソッドが失敗した場合は、エラーメッセージが表示され、どのように処理を進めるかがユーザーに問い合わされます。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_ISyncMgrResolutionHandler "{40A3D052-8BFF-4C4B-A338-D4A395700DE9}" #usecom global ISyncMgrResolutionHandler IID_ISyncMgrResolutionHandler "{}" #comfunc global ISyncMgrResolutionHandler_QueryAbilities 3 var #comfunc global ISyncMgrResolutionHandler_KeepOther 4 sptr,var #comfunc global ISyncMgrResolutionHandler_KeepRecent 5 var #comfunc global ISyncMgrResolutionHandler_RemoveFromSyncSet 6 var #comfunc global ISyncMgrResolutionHandler_KeepItems 7 sptr,var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_ISyncMgrResolutionHandler "{40A3D052-8BFF-4C4B-A338-D4A395700DE9}" #usecom global ISyncMgrResolutionHandler IID_ISyncMgrResolutionHandler "{}" #comfunc global ISyncMgrResolutionHandler_QueryAbilities 3 sptr #comfunc global ISyncMgrResolutionHandler_KeepOther 4 sptr,sptr #comfunc global ISyncMgrResolutionHandler_KeepRecent 5 sptr #comfunc global ISyncMgrResolutionHandler_RemoveFromSyncSet 6 sptr #comfunc global ISyncMgrResolutionHandler_KeepItems 7 sptr,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。