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

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

구문

HRESULT IsEnabled();

반환 값

형식: HRESULT

처리기가 사용되는 경우 S_OK 반환합니다. 그렇지 않으면 S_FALSE.

처리기에서 동기화 센터에서 현재 상태를 유지하려는 경우 E_NOTIMPL 반환할 수 있습니다. 다른 값이 반환되면 동기화 센터는 처리기의 사용 상태를 마지막으로 알려진 값으로 설정하고 연결된 작업을 적절하게 사용하거나 사용하지 않도록 설정합니다.

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

설명

처리기를 사용하지 않도록 설정하면 해당 처리기와 해당 항목 중 어느 것도 동기화 센터에서 동기화되지 않습니다. 또한 동기화와 같은 처리기에서 사용할 수 있는 많은 작업이 동기화 센터 폴더 UI에서 제거되거나 비활성화됩니다.

이 값은 폴더 UI에서 System.Sync.Enabled(PKEY_Sync_Enabled) 속성으로 사용할 수 있습니다.

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

예제

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

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

요구 사항

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

추가 정보

사용

ISyncMgrHandlerInfo