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

동기화 센터에 처리기 컬렉션을 다시 열거하도록 지시하거나 처리기 컬렉션의 처리기 속성이 변경되었다는 것을 알릴 수 있습니다.

구문

HRESULT UpdateHandlerCollection(
  [in] REFCLSID              rclsidCollectionID,
  [in] SYNCMGR_CONTROL_FLAGS nControlFlags
);

매개 변수

[in] rclsidCollectionID

형식: REFCLSID

처리기 컬렉션의 CLSID에 대한 참조입니다.

[in] nControlFlags

형식: SYNCMGR_CONTROL_FLAGS

업데이트를 동기적으로 또는 비동기적으로 수행할지 여부를 지정하는 SYNCMGR_CONTROL_FLAGS 열거형의 값입니다.

반환 값

형식: HRESULT

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

설명

nControlFlags 매개 변수에 SYNCMGR_CF_WAIT 설정된 경우 Sync Center가 지정된 처리기 컬렉션을 로드하고 모든 처리기 및 항목 정보를 다시 로드할 때까지 UpdateHandlerCollection이 반환되지 않습니다.

예제

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

void CMyDeviceHandler::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 that a new computer has been added.
        hr = pControl->UpdateHandlerCollection(CLSID_FRSHandlerCollection,
                                               SYNCMGR_CF_NOWAIT);
        pControl->Release();
    }

    ...

}

요구 사항

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