Metodo ISyncMgrCallback::AddItemToSession (syncmgr.h)

Articolo
03/02/2024

Aggiunge un elemento specificato al set di elementi attualmente sincronizzati.

Sintassi

HRESULT AddItemToSession(
  [in] LPCWSTR pszItemID
);

Parametri

[in] pszItemID

Tipo: LPCWSTR

Puntatore a un buffer contenente l'ID univoco dell'elemento da aggiungere. Questa stringa è di lunghezza massima MAX_SYNCMGR_ID incluso il carattere null di terminazione.

Valore restituito

Tipo: HRESULT

Restituisce S_OK in caso di esito positivo o un valore di errore in caso contrario. Restituisce E_INVALIDARG se pszItemID fa già parte della sessione.

Commenti

ISyncMgrSyncCallback::AddItemToSession viene chiamato dal gestore di sincronizzazione.

Esempio

Nell'esempio seguente viene illustrato l'utilizzo di ISyncMgrSyncCallback::AddItemToSession dal metodo 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();
    }
    ...
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	syncmgr.h

Condividi tramite