Metode ISyncMgrSyncCallback::P roposeItem (syncmgr.h)

Artikel
08/26/2023

Mengusulkan penambahan item baru ke kumpulan item yang sebelumnya dijumlahkan.

Sintaks

HRESULT ProposeItem(
  [in] ISyncMgrSyncItem *pNewItem
);

Parameter

[in] pNewItem

Jenis: ISyncMgrSyncItem*

Penunjuk ke instans ISyncMgrSyncItem yang mewakili item baru.

Menampilkan nilai

Jenis: HRESULT

Mengembalikan S_OK jika berhasil, atau nilai kesalahan sebaliknya. Mengembalikan E_INVALIDARG jika pszItemID sudah ada.

Keterangan

ISyncMgrSyncCallback::P roposeItem biasanya dipanggil ketika item tidak dianggap sebagai bagian dari set sinkronisasi kecuali telah berhasil disinkronkan. Pusat Sinkronisasi tidak menampilkan item ini di UI hingga metode ISyncMgrSyncCallback::CommitItem telah dipanggil.

Contoh

Contoh berikut menunjukkan penggunaan ISyncMgrSyncCallback::P roposeItem dan ISyncMgrSyncCallback::CommitItem dengan metode 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();
        }
    }
    ...
}

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	syncmgr.h

Bagikan melalui