ISyncMgrControl：：UpdateHandlerCollection 方法 (syncmgr.h)

指示同步中心繼續處理常式集合，或通知處理常式集合中的處理常式屬性已變更。

語法

HRESULT UpdateHandlerCollection(
  [in] REFCLSID              rclsidCollectionID,
  [in] SYNCMGR_CONTROL_FLAGS nControlFlags
);

參數

[in] rclsidCollectionID

類型： REFCLSID

處理常式集合 CLSID 的參考。

[in] nControlFlags

類型： SYNCMGR_CONTROL_FLAGS

來自 SYNCMGR_CONTROL_FLAGS 列舉的值，指定是否應該以同步或非同步方式執行更新。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

如果在 nControlFlags 參數中設定SYNCMGR_CF_WAIT， 則 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