Metodo ISyncMgrSyncCallback::P roposeItem (syncmgr.h)

Propone l'aggiunta di un nuovo elemento al set di elementi enumerati in precedenza.

Sintassi

HRESULT ProposeItem(
  [in] ISyncMgrSyncItem *pNewItem
);

Parametri

[in] pNewItem

Tipo: ISyncMgrSyncItem*

Puntatore a un'istanza di ISyncMgrSyncItem che rappresenta il nuovo elemento.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo o un valore di errore in caso contrario. Restituisce E_INVALIDARG se pszItemID esiste già.

Commenti

ISyncMgrSyncCallback::P roposeItem viene in genere chiamato quando gli elementi non vengono considerati parte del set di sincronizzazione a meno che non siano stati sincronizzati correttamente. Sync Center non visualizza questo elemento nell'interfaccia utente finché non viene chiamato il metodo ISyncMgrCallback::CommitItem .

Esempio

Nell'esempio seguente viene illustrato l'utilizzo di ISyncMgrSyncCallback::P roposeItem e ISyncMgrSyncCallback::CommitItem dal metodo Sync .

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();
        }
    }
    ...
}

Requisiti