ISyncMgrControl::EnableItem 메서드(syncmgr.h)

지정된 처리기에서 관리하는 동기화 항목을 사용하거나 사용하지 않도록 설정합니다.

구문

HRESULT EnableItem(
  [in] BOOL                  fEnable,
  [in] LPCWSTR               pszHandlerID,
  [in] LPCWSTR               pszItemID,
  [in] HWND                  hwndOwner,
  [in] SYNCMGR_CONTROL_FLAGS nControlFlags
);

매개 변수

[in] fEnable

형식: BOOL

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

[in] pszHandlerID

형식: LPCWSTR

처리기의 고유 ID를 포함하는 버퍼에 대한 포인터입니다. 이 문자열은 종료 null 문자를 포함하여 MAX_SYNCMGR_ID 최대 길이입니다.

[in] pszItemID

형식: LPCWSTR

항목의 고유 ID를 포함하는 버퍼에 대한 포인터입니다. 이 문자열은 종료 null 문자를 포함하여 MAX_SYNCMGR_ID 최대 길이입니다.

[in] hwndOwner

형식: HWND

항목에서 필요한 UI를 표시하는 데 사용할 수 있는 창에 대한 핸들입니다. 이 값은 NULL일 수 있습니다.

[in] nControlFlags

형식: SYNCMGR_CONTROL_FLAGS

항목의 사용 또는 비활성화를 동기적으로 또는 비동기적으로 수행할지 여부를 지정하는 SYNCMGR_CONTROL_FLAGS 열거형의 값입니다.

반환 값

형식: HRESULT

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

설명

활성화된 항목은 동기화할 수 있는 항목입니다.

지정한 항목이 GetCapabilities 메서드에서 반환된 마스크의 SYNCMGR_ICM_QUERY_BEFORE_ENABLE 또는 SYNCMGR_ICM_QUERY_BEFORE_DISABLE 반환하는 경우 항목을 사용하거나 사용하지 않도록 설정하기 전에 요청된 확인 대화 상자가 사용자에게 표시됩니다. 쿼리 UI가 요청되지 않거나 사용자가 작업을 확인한 후 항목의 Enable 메서드가 호출됩니다.

nControlFlags 매개 변수에 SYNCMGR_CF_WAIT 설정된 경우 동기화 센터에서 이 알림을 처리할 때까지 EnableItem이 반환되지 않습니다.

예제

다음 예제에서는 처리기의 프로시저에서 ISyncMgrControl::EnableHandler 를 사용하는 방법을 보여 줍니다.

void MiscProc(...)
{
    ...

    // Get the Sync Center control object.
    ISyncMgrControl *pControl = NULL;
    
    hr = CoCreateInstance(CLSID_SyncMgrControl, 
                          CLSCTX_SERVER, 
                          IID_PPV_ARGS(&pControl));
    if (SUCCEEDED(hr))
    {
        // Tell Sync Center to disable the item.
        hr = pControl->EnableItem(FALSE, 
                                  s_szMySyncHandlerID,
                                  s_szMySyncHandlerMusicContentID, 
                                  hwnd,
                                  SYNCMGR_CF_WAIT);
        pControl->Release();
    }

    ...

}

요구 사항

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