ISyncMgrControl::UpdateHandlerCollection メソッド (syncmgr.h)
Sync Center にハンドラー コレクションの再設定を指示するか、ハンドラー コレクション内のハンドラーのプロパティが変更されたことを通知します。
構文
HRESULT UpdateHandlerCollection(
[in] REFCLSID rclsidCollectionID,
[in] SYNCMGR_CONTROL_FLAGS nControlFlags
);
パラメーター
[in] rclsidCollectionID
型: REFCLSID
ハンドラー コレクションの CLSID への参照。
[in] nControlFlags
更新を同期的または非同期的に実行するかどうかを指定する 、SYNCMGR_CONTROL_FLAGS 列挙の値。
戻り値
種類: HRESULT
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
解説
SYNCMGR_CF_WAITが nControlFlags パラメーターに設定されている場合、UpdateHandlerCollection は、指定されたハンドラー コレクションを読み込み、すべてのハンドラーとアイテム情報を再読み込みするまで、UpdateHandlerCollection は返されません。
例
次の例は、ハンドラーのプロシージャによる ISyncMgrControl::UpdateHandlerCollection の使用方法を示しています。
void CMyDeviceHandler::MiscProc(...)
{
...
// Get the Sync Center control object.
ISyncMgrControl *pControl = NULL;
hr = CoCreateInstance(CLSID_SyncMgrControl,
CLSCTX_SERVER,
IID_PPV_ARGS(&pControl));
if (SUCCEEDED(hr))
{
// Tell Sync Center that a new computer has been added.
hr = pControl->UpdateHandlerCollection(CLSID_FRSHandlerCollection,
SYNCMGR_CF_NOWAIT);
pControl->Release();
}
...
}
要件
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | syncmgr.h |