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

동기화 센터에 동기화 항목의 속성이 변경되었다는 것을 알립니다.

구문

HRESULT UpdateItem(
  [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 최대 길이입니다.

[in] nControlFlags

형식: SYNCMGR_CONTROL_FLAGS

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

반환 값

형식: HRESULT

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

설명

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

예제

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

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 properties of the item have changed.
        hr = pControl->UpdateItem(s_szMySyncHandlerID,
                                  s_szMySyncHandlerMusicContentID,
                                  SYNCMGR_CF_WAIT);
        pControl->Release();
    }

    ...

}

요구 사항

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