Método ISyncMgrSyncCallback::P roposeItem (syncmgr.h)

Propõe a adição de um novo item ao conjunto de itens enumerados anteriormente.

Sintaxe

HRESULT ProposeItem(
  [in] ISyncMgrSyncItem *pNewItem
);

Parâmetros

[in] pNewItem

Tipo: ISyncMgrSyncItem*

Um ponteiro para uma instância de ISyncMgrSyncItem que representa o novo item.

Valor retornado

Tipo: HRESULT

Retorna S_OK se tiver êxito; caso contrário, um valor de erro. Retorna E_INVALIDARG se pszItemID já existir.

Comentários

ISyncMgrSyncCallback::P roposeItem normalmente é chamado quando os itens não são considerados parte do conjunto de sincronização, a menos que tenham sido sincronizados com êxito. O Sync Center não exibe esse item na interface do usuário até que o método ISyncMgrSyncCallback::CommitItem tenha sido chamado.

Exemplos

O exemplo a seguir mostra o uso de ISyncMgrSyncCallback::P roposeItem e ISyncMgrSyncCallback::CommitItem pelo método 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();
        }
    }
    ...
}

Requisitos