Méthode ISyncMgrSyncCallback ::AddItemToSession (syncmgr.h)

Article
03/02/2024

Ajoute un élément spécifié à l’ensemble d’éléments en cours de synchronisation.

Syntaxe

HRESULT AddItemToSession(
  [in] LPCWSTR pszItemID
);

Paramètres

[in] pszItemID

Type : LPCWSTR

Pointeur vers une mémoire tampon contenant l’ID unique de l’élément à ajouter. Cette chaîne est de longueur maximale MAX_SYNCMGR_ID y compris le caractère null de fin.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite, ou une valeur d’erreur dans le cas contraire. Retourne E_INVALIDARG si pszItemID fait déjà partie de la session.

Remarques

ISyncMgrSyncCallback ::AddItemToSession est appelé par le gestionnaire de synchronisation.

Exemples

L’exemple suivant montre l’utilisation d’ISyncMgrSyncCallback ::AddItemToSession par la méthode Synchronize .

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	syncmgr.h

Partager via