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

특정 처리기 또는 항목에 대한 이벤트가 추가되었음을 동기화 센터에 알립니다.

구문

HRESULT UpdateEvents(
  [in] LPCWSTR               pszHandlerID,
  [in] LPCWSTR               pszItemID,
  [in] SYNCMGR_CONTROL_FLAGS nControlFlags
);

매개 변수

[in] pszHandlerID

형식: LPCWSTR

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

[in] pszItemID

형식: LPCWSTR

항목의 고유 ID를 포함하는 버퍼에 대한 포인터입니다. 이 문자열은 종료 null 문자를 포함하여 MAX_SYNCMGR_ID 최대 길이입니다. 이벤트가 특정 항목이 아닌 처리기에서 발생한 경우 이 매개 변수는 NULL 일 수 있습니다.

[in] nControlFlags

형식: SYNCMGR_CONTROL_FLAGS

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

반환 값

형식: HRESULT

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

설명

nControlFlags 매개 변수에 SYNCMGR_CF_WAIT 설정된 경우 Sync Center가 지정된 처리기를 로드하고 처리기의 이벤트 저장소를 검색한 후 해당 저장소에서 모든 이벤트를 다시 로드할 때까지 UpdateEvents가 반환되지 않습니다. 처리기 컬렉션에서 처리기를 제공하는 경우 처리기 컬렉션도 로드되어 처리기를 다시 로드합니다.

예제

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

void CMyDeviceHandler::Synchronize(...)
{
    ...
    // Add events to the event store.

    // 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 we added events to our event store.
        // By passing NULL in pszItemID, we tell Sync Center that the event
        // occurred on the handler rather than a specific item.
        hr = pControl->UpdateEvents(s_szMyDeviceSyncHandlerID, 
                                    NULL,
                                    SYNCMGR_CF_NOWAIT);
        pControl->Release();
    }

    ...

}

요구 사항

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