ISyncMgrSyncCallback::AddItemToSession-Methode (syncmgr.h)

Artikel
03/04/2024

Fügt dem Satz von Elementen, die derzeit synchronisiert werden, ein angegebenes Element hinzu.

Syntax

HRESULT AddItemToSession(
  [in] LPCWSTR pszItemID
);

Parameter

[in] pszItemID

Typ: LPCWSTR

Ein Zeiger auf einen Puffer, der die eindeutige ID des hinzuzufügenden Elements enthält. Diese Zeichenfolge hat eine maximale Länge MAX_SYNCMGR_ID einschließlich des beendenden NULL-Zeichens .

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlerwert zurück. Gibt E_INVALIDARG zurück, wenn pszItemID bereits Teil der Sitzung ist.

Hinweise

ISyncMgrSyncCallback::AddItemToSession wird vom Synchronisierungshandler aufgerufen.

Beispiele

Das folgende Beispiel zeigt die Verwendung von ISyncMgrSyncCallback::AddItemToSession durch die Synchronize-Methode .

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	syncmgr.h

Freigeben über