共用方式為


ISyncMgrHandler::Enable 方法 (syncmgr.h)

要求啟用或停用 作用中的 處理常式。 啟用的處理常式可以同步處理,而且無法停用的處理常式。

語法

HRESULT Enable(
  [in] BOOL fEnable
);

參數

[in] fEnable

類型: BOOL

TRUE 表示啟用; 停用的 FALSE。

傳回值

類型: HRESULT

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

備註

當處理常式顯示在 [同步中心] 資料夾中時,處理常式必須設定 [啟用] 和 [停用] 專案的SYNCMGR_HCM_CAN_ENABLESYNCMGR_HCM_CAN_DISABLE旗標,才會出現在處理常式的快捷方式功能表上。 選擇啟用處理常式表示它可以同步處理;選擇停用處理程式表示它無法。

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

  • 當使用者在 [同步中心] 資料夾中選取處理常式,並啟動其 [啟用 ] 工作時。 如果處理常式支援 SYNCMGR_OBJECTID_QueryBeforeEnable 物件,則只有在 UI 作業成功時,才會呼叫這個方法。
  • 當使用者在 [同步中心] 資料夾中選取處理常式,並啟動其 [停用 ] 工作時。 如果處理常式支援 SYNCMGR_OBJECTID_QueryBeforeDisable 物件,則只有在 UI 作業成功時,才會呼叫這個方法。
如果處理常式不需要在啟動時執行任何動作,它可以傳回S_OK或E_NOTIMPL,如下列範例所示。

範例

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

STDMETHODIMP CMyDeviceHandler::Enable(__in BOOL fEnable)
{
    return E_NOTIMPL;
}

需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 syncmgr.h

另請參閱

ISyncMgrHandler

ISyncMgrHandler::GetObject

IsEnabled