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

항목이 사용되는지 여부를 나타내는 값을 생성합니다.

구문

HRESULT IsEnabled();

반환 값

형식: HRESULT

항목이 사용하도록 설정된 경우 S_OK 반환합니다. 그렇지 않으면 S_FALSE.

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

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

설명

항목을 사용하지 않도록 설정하면 동기화 센터에서 동기화되지 않습니다. 또한 동기화와 같은 항목에 사용할 수 있는 많은 작업이 UI에서 제거되거나 비활성화됩니다.

항목은 IsEnabled에서 S_FALSE 반환하고 GetPolicies 구현에서 SYNCMR_IPM_PREVENT_ENABLE 플래그를 설정하여 연결이 끊긴 상태를 구현할 수 있습니다. 이렇게 하면 항목이 사용 안 함으로 표시되고 사용자가 수동으로 사용하도록 설정할 수 없습니다.

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

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

예제

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

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

요구 사항