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

Article
08/26/2023

Propose l’ajout d’un nouvel élément à l’ensemble d’éléments précédemment énumérés.

Syntaxe

HRESULT ProposeItem(
  [in] ISyncMgrSyncItem *pNewItem
);

Paramètres

[in] pNewItem

Type : ISyncMgrSyncItem*

Pointeur vers un instance d’ISyncMgrSyncItem représentant le nouvel élément.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite, ou une valeur d’erreur dans le cas contraire. Retourne E_INVALIDARG si pszItemID existe déjà.

Remarques

ISyncMgrSyncCallback::P roposeItem est généralement appelé lorsque les éléments ne sont pas considérés comme faisant partie du jeu de synchronisation, sauf s’ils ont été correctement synchronisés. Le Centre de synchronisation n’affiche pas cet élément dans l’interface utilisateur tant que la méthode ISyncMgrSyncCallback::CommitItem n’a pas été appelée.

Exemples

L’exemple suivant montre l’utilisation de ISyncMgrSyncCallback::P roposeItem et ISyncMgrSyncCallback::CommitItem par la méthode 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();
        }
    }
    ...
}

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	syncmgr.h

Partager via