Share via

ISyncMgrSyncCallback：：AddItemToSession 方法 (syncmgr.h)

  • 發行項

將指定的專案新增至目前正在同步處理的專案集。

語法

HRESULT AddItemToSession(
  [in] LPCWSTR pszItemID
);

參數

[in] pszItemID

類型： LPCWSTR

緩衝區的指標，其中包含要加入之專案的唯一標識符。 此字串長度上限MAX_SYNCMGR_ID包括終止 Null 字元。

傳回值

類型： HRESULT

如果成功，則傳回S_OK，否則傳回錯誤值。 如果 pszItemID 已經是會話的一部分，則傳回E_INVALIDARG。

備註

同步處理程式會呼叫 ISyncMgrSyncCallback：：AddItemToSession。

範例

下列範例顯示 Synchronize 方法使用 ISyncMgrSyncCallback：：AddItemToSession。

HRESULT CMyDeviceHandler::Synchronize(...)
{
    ...

    // Start synchronizing the handler.

    ...

    // Check for additional items to sync.
    IEnumString *penumItemIDs = NULL;
    
    hr = pCallback->QueryForAdditionalItems(&penumItemIDs);
    if (hr == S_OK)
    {
        while (hr == S_OK)
        {
            LPWSTR pszItemID;
            ULONG cFetched;
            hr = penumItemIDs->Next(1, &pszItemID, &cFetched);
            if ((hr == S_OK) && (cFetched == 1))
            {
                // Add this item to the set of items we are syncing.
                hr = pCallback->AddItemToSession(pszItemID);
                CoTaskMemFree(pszItemID);
            }
        }
        penumItemIDs->Release();
    }
    ...
}

規格需求

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