ISyncMgrHandler：：Activate 方法 (syncmgr.h)

啟動或停用處理程式的要求。可以同步處理使用中的處理常式;非作用中的處理常式無法。

語法

HRESULT Activate(
  [in] BOOL fActivate
);

[in] fActivate

類型： BOOL

TRUE 表示要啟用; FALSE 可停用。

類型： HRESULT

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

作用中的處理常式會出現在 [同步中心] 資料夾中，而且可以同步處理。非作用中的處理常式會出現在 [同步設定] 資料夾中，而且必須在 (將它移至 [同步中心] 資料夾) ，才能進行同步處理。

啟用狀態不應與啟用狀態混淆。作用中的處理常式可以停用。這表示它仍會顯示在 [同步中心] 資料夾中，但無法同步處理。

同步中心會在下列兩個實例中呼叫此方法。

當使用者在 [同步設定] 資料夾中選取處理常式，並啟動其 安裝程式 工作時。如果處理常式支援 SYNCMGR_OBJECTID_QueryBeforeActivate 物件，則只有在 UI 作業是由要求使用者確認是否要啟動處理常式的對話方塊所組成時，才會呼叫此方法。
當使用者選取 [同步中心] 資料夾中的處理常式並啟動其 [刪除 ] 工作時，但只有在處理常式尚未設定 SYNCMGR_HPM_PREVENT_DEACTI加值稅E 旗標時。如果處理常式支援 SYNCMGR_OBJECTID_QueryBeforeDeactivate 物件，則只有在 UI 作業成功時，才會呼叫此方法。

如果 SYNCMGR_HPM_PREVENT_ACTI加值稅E 旗標是在 ISyncMgrHandler：：GetCapabilities 所擷取的值中設定，則呼叫這個要求啟用處理常式的方法將會失敗。

呼叫 IsActive即可找到個別處理常式的啟用狀態。

如果處理常式不需要在啟動時執行任何動作，它可以傳回S_OK或E_NOTIMPL，如下列範例所示。

下列範例示範這個方法的簡單實作。

STDMETHODIMP CMyDeviceHandler::Activate(__in BOOL fActivate)
{
    return E_NOTIMPL;
}