ISyncMgrSyncCallback：:P roposeItem 方法 (syncmgr.h)

建議將新專案新增至先前列舉的專案集。

語法

HRESULT ProposeItem(
  [in] ISyncMgrSyncItem *pNewItem
);

參數

[in] pNewItem

類型： ISyncMgrSyncItem*

代表新專案的 ISyncMgrSyncItem 實例指標。

傳回值

類型： HRESULT

如果成功，則傳回S_OK，否則傳回錯誤值。 如果 pszItemID 已經存在，則傳回E_INVALIDARG。

備註

除非專案已成功同步處理，否則通常會呼叫ISyncMgrSyncCallback：:P roposeItem。 在 呼叫 ISyncMgrSyncCallback：：CommitItem 方法之前，同步中心不會在 UI 中顯示此專案。

範例

下列範例顯示Synchronize方法使用ISyncMgrSyncCallback：:P roposeItem和ISyncMgrSyncCallback：：CommitItem。

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

規格需求

最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	syncmgr.h