Share via


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

특정 처리기에서 관리하는 지정된 항목의 동기화를 시작합니다.

구문

HRESULT StartItemSync(
  [in] LPCWSTR                    pszHandlerID,
  [in] LPCWSTR                    *ppszItemIDs,
  [in] ULONG                      cItems,
  [in] HWND                       hwndOwner,
  [in] IUnknown                   *punk,
  [in] SYNCMGR_SYNC_CONTROL_FLAGS nSyncControlFlags,
  [in] ISyncMgrSyncResult         *pResult
);

매개 변수

[in] pszHandlerID

형식: LPCWSTR

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

[in] ppszItemIDs

형식: LPCWSTR*

동기화할 항목의 ID 배열을 포함하는 버퍼에 대한 포인터의 주소입니다. 각 ID는 종료 null 문자를 포함하여 MAX_SYNCMGR_ID 최대 길이입니다. 이 배열은 동기화에 전달됩니다.

[in] cItems

형식:DWORD

ppszItemIDs의 ID 수입니다.

[in] hwndOwner

형식: HWND

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

[in] punk

형식: IUnknown*

동기화에 전달할 IUnknown에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다.

[in] nSyncControlFlags

형식: SYNCMGR_SYNC_CONTROL_FLAGS

에 대기 중인 동기화가 수행될 때 현재 동기화와 큐에 대기 중인 동기화 모두에 있는 항목을 다시 동기화해야 하는지 여부를 지정하는 SYNCMGR_SYNC_CONTROL_FLAGS 열거형의 멤버입니다.

[in] pResult

형식: ISyncMgrSyncResult*

성공, 실패 또는 취소를 통해 동기화가 종료되면 Result 메서드가 호출되는 ISyncMgrSyncResult의 instance 대한 포인터입니다. Result 메서드는 처리기 동기화의 집계된 상태로 호출됩니다. 이 매개 변수는 NULL일 수 있습니다.

반환 값

형식: HRESULT

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

설명

이 메서드는 UpdateItems와 유사합니다.

예제

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

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))
    {
        // Synchronize one sync item for the sync handler.
        hr = pControl->StartItemSync(s_szMySyncHandlerID,
                                     s_szMySyncHandlerMusicContentID,
                                     1,
                                     _hwnd,
                                     NULL,
                                     NULL);
        pControl->Release();
    }

    ...

}

요구 사항

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