ISyncMgrSyncCallback::AddItemToSession メソッド (syncmgr.h)

現在同期されている項目のセットに指定した項目を追加します。

構文

HRESULT AddItemToSession(
  [in] LPCWSTR pszItemID
);

パラメーター

[in] pszItemID

種類: LPCWSTR

追加する項目の一意の ID を含むバッファーへのポインター。 この文字列は、終端の null 文字を含む最大長MAX_SYNCMGR_IDです。

戻り値

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

要件