Condividi tramite

Interfaccia ISyncMgrUIOperation (syncmgr.h)

  • Articolo

Espone un metodo tramite cui un gestore di sincronizzazione o un elemento di sincronizzazione può visualizzare un oggetto dell'interfaccia utente quando richiesto per farlo da Sync Center.

Ereditarietà

L'interfaccia ISyncMgrUIOperation eredita dall'interfaccia IUnknown . ISyncMgrUIOperation include anche questi tipi di membri:

Metodi

L'interfaccia ISyncMgrUIOperation include questi metodi.

 
ISyncMgrUIOperation::Run

Esegue la visualizzazione effettiva dell'interfaccia utente per un gestore o un elemento di sincronizzazione quando richiesto per farlo da Sync Center.

Commenti

I gestori implementano ISyncMgrUIOperation per fornire l'interfaccia utente per una determinata azione. Ogni azione separata (sfoglia, pianificazione, abilitazione/disabilitazione, attivazione/disattivazione ed eliminazione) richiede un'implementazione separata.

Un gestore deve implementare questa interfaccia solo per le operazioni per cui vuole presentare l'interfaccia utente.

Di seguito vengono riepilogati i passaggi eseguiti dal Centro sincronizzazione per creare un'istanza e usare questa interfaccia.

  1. Sync Center crea un thread separato per l'operazione dell'interfaccia utente.
  2. Sync Center crea una nuova istanza del gestore.
  3. Se l'operazione comporta solo un gestore, Sync Center chiama ISyncMgrHandler::GetObject con l'ID oggetto SYNCMGR_OBJECTID appropriato per ottenere un puntatore all'oggetto ISyncMgrUIOperation che implementa tale oggetto interfaccia utente. Ad esempio, Sync Center chiama ISyncMgrHandler::GetObject con SYNCMGR_OBJECTID_QueryBeforeDelete per ottenere un oggetto chiamato per visualizzare l'interfaccia utente quando l'utente sceglie di eliminare il gestore, chiedendo una conferma che vogliono effettivamente eliminarla.
  4. Se l'operazione prevede un elemento di sincronizzazione, Il Centro sincronizzazione effettua una serie di chiamate, incluse le operazioni seguenti:
    1. QueryInterface viene chiamato nell'interfaccia ISyncMgrHandler per recuperare un'istanza di ISyncMgrSyncItemContainer.
    2. ISyncMgrSyncItemContainer::GetSyncItem viene chiamato per ottenere un puntatore all'istanza ISyncMgrSyncItem che rappresenta l'elemento.
    3. ISyncMgrSyncItem::GetObject viene chiamato con l'ID oggetto SYNCMGR_OBJECTID appropriato per ottenere un puntatore all'oggetto ISyncMgrUIOperation che implementa l'oggetto UI.
  5. Sync Center chiama il metodo Run dell'oggetto ui per visualizzare l'interfaccia utente.
Implementando l'interfaccia utente come interfaccia separata, è possibile eseguire la visualizzazione dell'interfaccia utente in modo indipendente dalla sincronizzazione. ISyncMgrUIOperation deve essere implementato in un oggetto diverso da ISyncMgrHandler o ISyncMgrSyncItem.

Se l'utente richiede un'azione, richiede di nuovo la stessa azione prima del completamento della prima operazione, l'interfaccia utente per l'azione iniziale viene attivata e portata in primo piano.

Requisiti

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