Metodo ISyncMgrControl::StartItemSync (syncmgr.h)

Articolo
08/26/2023

Avvia la sincronizzazione degli elementi specificati gestiti da un gestore specifico.

Sintassi

HRESULT StartItemSync(
  [in] LPCWSTR                    pszHandlerID,
  [in] LPCWSTR                    *ppszItemIDs,
  [in] ULONG                      cItems,
  [in] HWND                       hwndOwner,
  [in] IUnknown                   *punk,
  [in] SYNCMGR_SYNC_CONTROL_FLAGS nSyncControlFlags,
  [in] ISyncMgrSyncResult         *pResult
);

Parametri

[in] pszHandlerID

Tipo: LPCWSTR

Puntatore a un buffer contenente l'ID univoco del gestore che gestisce gli elementi. Questa stringa è di lunghezza massima MAX_SYNCMGR_ID incluso il carattere null di terminazione.

[in] ppszItemIDs

Tipo: LPCWSTR*

Indirizzo di un puntatore a un buffer contenente una matrice di ID degli elementi da sincronizzare. Ogni ID è di lunghezza massima MAX_SYNCMGR_ID incluso il carattere Null di terminazione. Questa matrice viene passata a Synchronize.

[in] cItems

Tipo: DWORD

Numero di ID in ppszItemIDs.

[in] hwndOwner

Tipo: HWND

Handle per la finestra che l'elemento può usare per visualizzare qualsiasi interfaccia utente necessaria. Questo valore può essere NULL.

[in] punk

Tipo: IUnknown*

Puntatore a un oggetto IUnknown da passare a Synchronize. Questo parametro può essere NULL.

[in] nSyncControlFlags

Tipo: SYNCMGR_SYNC_CONTROL_FLAGS

Membro dell'enumerazione SYNCMGR_SYNC_CONTROL_FLAGS che specifica se un elemento trovato sia in una sincronizzazione corrente che in una sincronizzazione in coda deve essere sincronizzato nuovamente quando viene eseguita la sincronizzazione in coda.

[in] pResult

Tipo: ISyncMgrSyncResult*

Puntatore a un'istanza di ISyncMgrSyncResult, il cui metodo Result viene chiamato al termine della sincronizzazione, tramite esito positivo, negativo o annullamento. Il metodo Result viene chiamato con lo stato aggregato della sincronizzazione del gestore. Questo parametro può essere NULL.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo è analogo a UpdateItems.

Esempio

Nell'esempio seguente viene illustrato l'utilizzo di ISyncMgrControl::StartItemSync tramite la routine di un gestore.

void CMyDeviceHandler::MiscProc(...)
{
    ...

    // Get the Sync Center control object.
    ISyncMgrControl *pControl = NULL;
    
    hr = CoCreateInstance(CLSID_SyncMgrControl, 
                          CLSCTX_SERVER,
                          IID_PPV_ARGS(&pControl));
    if (SUCCEEDED(hr))
    {
        // Synchronize one sync item for the sync handler.
        hr = pControl->StartItemSync(s_szMySyncHandlerID,
                                     s_szMySyncHandlerMusicContentID,
                                     1,
                                     _hwnd,
                                     NULL,
                                     NULL);
        pControl->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