ISyncMgrSyncCallback：：AddItemToSession 方法 (syncmgr.h)

  • 项目

将指定的项添加到当前正在同步的项集中。

语法

HRESULT AddItemToSession(
  [in] LPCWSTR pszItemID
);

参数

[in] pszItemID

类型： LPCWSTR

指向包含要添加的项的唯一 ID 的缓冲区的指针。 此字符串的最大长度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