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_DEACTIVATE 플래그를 설정하지 않은 경우에만 시작합니다. 처리기가 SYNCMGR_OBJECTID_QueryBeforeDeactivate 개체를 지원하는 경우 이 메서드는 UI 작업이 성공한 경우에만 호출됩니다.

ISyncMgrHandler::GetCapabilities에서 검색한 값에서 SYNCMGR_HPM_PREVENT_ACTIVATE 플래그를 설정하면 처리기의 활성화를 요청하는 이 메서드에 대한 호출이 실패합니다.

IsActive를 호출하여 개별 처리기의 활성화 상태를 찾을 수 있습니다.

처리기가 활성화될 때 작업을 수행할 필요가 없는 경우 아래 예제와 같이 S_OK 또는 E_NOTIMPL 반환할 수 있습니다.

다음 예제에서는 이 메서드의 간단한 구현을 보여줍니다.

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