Share via

ISyncMgrHandlerInfo::IsActive 메서드(syncmgr.h)

  • 아티클

처리기를 동기화할 수 있는지 여부를 나타내는 값을 가져옵니다.

구문

HRESULT IsActive();

반환 값

형식: HRESULT

처리기가 활성 상태이면 S_OK 반환합니다. 그렇지 않으면 S_FALSE.

처리기가 동기화 센터에서 현재 상태를 유지하려면 E_NOTIMPL 반환할 수 있습니다. 다른 값이 반환되면 동기화 센터는 처리기의 상태를 마지막으로 알려진 값으로 설정합니다. 해당 상황에서 처리기의 마지막으로 알려진 값이 비활성 상태이면 동기화 센터에서 설치 작업을 사용하지 않도록 설정합니다. 처리기의 마지막으로 알려진 값이 활성 상태이면 삭제 작업이 비활성화되지 않습니다.

GetCapabilities에서 반환된 마스크에 SYNCMGR_HCM_QUERY_BEFORE_ACTIVATE 또는 SYNCMGR_HCM_QUERY_BEFORE_DEACTIVE 플래그가 설정된 경우 처리기는 자체 활성화 상태를 관리해야 하므로 S_OK 또는 S_FALSE 반환해야 합니다. 다른 반환 값은 오류로 간주됩니다.

설명

처리기가 활성 상태가 아닌 경우 동기화 설정 폴더에 표시됩니다. 해당 폴더의 처리기는 동기화할 수 없습니다. 처리기를 동기화 센터 폴더로 이동하려면 사용자는 처리기의 바로 가기 메뉴 또는 명령 모듈에서 설치 작업을 선택합니다.

처리기가 활성 상태이면 기본 동기화 센터 폴더에 표시됩니다. 활성 처리기는 사용자가 또는 ISyncMgrControl 인터페이스를 통해 동기화할 수 있습니다. 처리기를 동기화 설정 폴더로 이동하려면 사용자는 처리기의 바로 가기 메뉴 또는 명령 모듈에서 삭제 작업을 선택합니다.

Sync Center는 UpdateHandler 메서드가 호출 될 때마다이 메서드를 호출합니다.

예제

다음 예제에서는 활성 상태를 검색 하는 프라이빗 클래스 함수를 호출 하는이 메서드의 구현을 보여 주는 합니다.

STDMETHODIMP CMyDeviceHandler::IsActive()
{
    // Return a previously-calculated value.
    return (_fIsActive ? S_OK : S_FALSE);
}

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 syncmgr.h

추가 정보

활성화

ISyncMgrHandlerInfo