ISyncMgrSyncItem::Enable メソッド (syncmgr.h)

同期項目を有効または無効にします。

構文

HRESULT Enable(
  [in] BOOL fEnable
);

[in] fEnable

種類: BOOL

有効にする場合は TRUE 。 無効にする場合は FALSE 。

型: HRESULT

このメソッドは、成功すると S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。

Sync Center は、次のシナリオでこのメソッドを呼び出します。

ユーザーがハンドラーのフォルダー内の項目を選択し、 その Enable タスクを起動したとき(ただし、アイテムが SYNCMGR_IPM_PREVENT_ENABLE フラグを設定していない場合のみ)。ハンドラーが SYNCMGR_OBJECTID_QueryBeforeEnable オブジェクトをサポートしている場合、このメソッドは UI 操作が成功した場合にのみ呼び出されます。
ユーザーがハンドラーのフォルダー内の項目を選択し、 その Disable タスクを起動したとき(ただし、アイテムが SYNCMGR_IPM_PREVENT_DISABLE フラグを設定していない場合のみ)。ハンドラーが SYNCMGR_OBJECTID_QueryBeforeDisable オブジェクトをサポートしている場合、このメソッドは UI 操作が成功した場合にのみ呼び出されます。

ハンドラーがアクティブ化されたときにアクションを実行する必要がない場合は、次の例に示すように、S_OKまたはE_NOTIMPLのいずれかを返すことができます。

次の例は、このメソッドの簡単な実装を示しています。

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