ISyncMgrSessionCreator::CreateSession 메서드(syncmgr.h)

동기화 센터에 지정된 항목의 동기화가 시작되었음을 알 수 있습니다.

구문

HRESULT CreateSession(
  [in] LPCWSTR              pszHandlerID,
  [in] LPCWSTR              *ppszItemIDs,
  [in] ULONG                cItems,
  [in] ISyncMgrSyncCallback **ppCallback
);

매개 변수

[in] pszHandlerID

형식: LPCWSTR

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

[in] ppszItemIDs

형식: LPCWSTR*

동기화할 pszHandlerID에 지정된 처리기에서 관리하는 항목 ID 배열을 포함하는 버퍼에 대한 포인터의 주소입니다. 각 ID는 종료 null 문자를 포함하여 MAX_SYNCMGR_ID 최대 길이입니다.

[in] cItems

형식: ULONG

ppszItemIDs에서 참조되는 버퍼에 포함된 항목 ID의 수입니다.

[in] ppCallback

형식: ISyncMgrSyncCallback**

진행률 및 이벤트를 보고하는 데 사용되는 ISyncMgrSyncCallback instance 대한 포인터의 주소입니다. 콜백이 필요하지 않은 경우 이 값은 NULL 일 수 있습니다.

반환 값

형식: HRESULT

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

설명

pszHandlerID와 ppszItemID를 모두 지정해야 합니다.

예제

다음 예제에서는 이 메서드 구현의 개요를 보여 있습니다.

STDMETHODIMP CMyDeviceHandler::Synchronize(...)
{
    ...
    ISyncMgrSyncCallback *pCallback = NULL;

    hr = pCreator->CreateSession(_pszHandlerID, ppszItemIDs, cItems, &pCallback);
    if (SUCCEEDED(hr))
    {
        // Perform synchronization.
    }

    return hr;
}

요구 사항

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