Метод ISyncMgrSyncCallback::P roposeItem (syncmgr.h)

Предлагает добавление нового элемента в набор элементов, перечисленных ранее.

Синтаксис

HRESULT ProposeItem(
  [in] ISyncMgrSyncItem *pNewItem
);

Параметры

[in] pNewItem

Тип: ISyncMgrSyncItem*

Указатель на экземпляр ISyncMgrSyncItem , представляющий новый элемент.

Возвращаемое значение

Тип: HRESULT

Возвращает S_OK в случае успешного выполнения или значение ошибки в противном случае. Возвращает E_INVALIDARG, если pszItemID уже существует.

Комментарии

ISyncMgrSyncCallback::P roposeItem обычно вызывается, если элементы не считаются частью набора синхронизации, если они не были успешно синхронизированы. Центр синхронизации не отображает этот элемент в пользовательском интерфейсе, пока не будет вызван метод ISyncMgrSyncCallback::CommitItem .

Примеры

В следующем примере показано использование ISyncMgrSyncCallback::P roposeItem и ISyncMgrSyncCallback::CommitItem методом Synchronize .

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

    // Start synchronizing the handler.

    ...

    // Find items waiting to be created.
    for (...)
    {
        // Create the item.
        ISyncMgrSyncItem *pNewItem = NULL;
        LPWSTR szItemID[MAX_SYNCMGR_ID];
        
        hr = GetNextNewItem(&pNewItem, szItemID, ARRAYSIZE(szItemID));
        if (SUCCEEDED(hr))
        {
            // Propose this item to Sync Center.
            hr = pCallback->ProposeItem(pNewItem);
            if (SUCCEEDED(hr))
            {
                // Synchronize the item.
                // Synchronization was successful.  Commit the item.
                hr = pCallback->CommitItem(szItemID);
            }
            pNewItem->Release();
        }
    }
    ...
}

Требования