ISyncMgrSyncCallback::AddItemToSession 메서드(syncmgr.h)

현재 동기화 중인 항목 집합에 지정된 항목을 추가합니다.

구문

HRESULT AddItemToSession(
  [in] LPCWSTR pszItemID
);

매개 변수

[in] pszItemID

형식: LPCWSTR

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

반환 값

형식: HRESULT

성공하면 S_OK 반환하고, 그렇지 않으면 오류 값을 반환합니다. pszItemID가 이미 세션에 포함된 경우 E_INVALIDARG 반환합니다.

설명

ISyncMgrSyncCallback::AddItemToSession 은 동기화 처리기에서 호출됩니다.

예제

다음 예제에서는 Synchronize 메서드에서 ISyncMgrSyncCallback::AddItemToSession을 사용하는 방법을 보여 줍니다.

HRESULT CMyDeviceHandler::Synchronize(...)
{
    ...

    // Start synchronizing the handler.

    ...

    // Check for additional items to sync.
    IEnumString *penumItemIDs = NULL;
    
    hr = pCallback->QueryForAdditionalItems(&penumItemIDs);
    if (hr == S_OK)
    {
        while (hr == S_OK)
        {
            LPWSTR pszItemID;
            ULONG cFetched;
            hr = penumItemIDs->Next(1, &pszItemID, &cFetched);
            if ((hr == S_OK) && (cFetched == 1))
            {
                // Add this item to the set of items we are syncing.
                hr = pCallback->AddItemToSession(pszItemID);
                CoTaskMemFree(pszItemID);
            }
        }
        penumItemIDs->Release();
    }
    ...
}

요구 사항

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