ISyncMgrHandler::Enable 메서드(syncmgr.h)

활성 처리기를 사용하거나 사용하지 않도록 설정하도록 요청합니다. 활성화된 처리기는 동기화할 수 있으며 비활성화된 처리기는 동기화할 수 없습니다.

구문

HRESULT Enable(
  [in] BOOL fEnable
);

매개 변수

[in] fEnable

형식: BOOL

TRUE 를 사용하도록 설정하려면 이고, FALSE 를 사용하여 사용하지 않도록 설정합니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

처리기가 동기화 센터 폴더에 표시되면 처리기가 처리기의 바로 가기 메뉴에 표시되도록 사용사용 안 함 항목에 대한 SYNCMGR_HCM_CAN_ENABLE 및 SYNCMGR_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