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

Propone la adición de un nuevo elemento al conjunto de elementos enumerados anteriormente.

Sintaxis

HRESULT ProposeItem(
  [in] ISyncMgrSyncItem *pNewItem
);

Parámetros

[in] pNewItem

Tipo: ISyncMgrSyncItem*

Puntero a una instancia de ISyncMgrSyncItem que representa el nuevo elemento.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se realiza correctamente; de lo contrario, un valor de error. Devuelve E_INVALIDARG si pszItemID ya existe.

Comentarios

Se suele llamar a ISyncMgrSyncCallback::P roposeItem cuando los elementos no se consideran parte del conjunto de sincronización a menos que se hayan sincronizado correctamente. El Centro de sincronización no muestra este elemento en la interfaz de usuario hasta que se haya llamado al método ISyncMgrSyncCallback::CommitItem .

Ejemplos

En el ejemplo siguiente se muestra el uso de ISyncMgrSyncCallback::P roposeItem e ISyncMgrSyncCallback::CommitItem por el 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

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	syncmgr.h