ISyncMgrUIOperation-Schnittstelle (syncmgr.h)

  • Artikel

Macht eine Methode verfügbar, mit der ein Synchronisierungshandler oder Synchronisierungselement ein UI-Objekt anzeigen kann, wenn dies vom Sync Center angefordert wird.

Vererbung

Die ISyncMgrUIOperation-Schnittstelle erbt von der IUnknown-Schnittstelle . ISyncMgrUIOperation verfügt auch über folgende Membertypen:

Methoden

Die ISyncMgrUIOperation-Schnittstelle verfügt über diese Methoden.

 
ISyncMgrUIOperation::Ausführen

Führt die tatsächliche Anzeige der Benutzeroberfläche für einen Handler oder Synchronisierungselement aus, wenn dies vom Synchronisierungscenter angefordert wird.

Hinweise

Handler implementieren ISyncMgrUIOperation , um die Benutzeroberfläche für eine bestimmte Aktion bereitzustellen. Jede separate Aktion (Durchsuchen, Planen, Aktivieren/Deaktivieren, Aktivieren/Deaktivieren und Löschen) erfordert eine separate Implementierung.

Ein Handler sollte diese Schnittstelle nur für Vorgänge implementieren, für die er die Benutzeroberfläche darstellen möchte.

Im Folgenden werden die Schritte des Synchronisierungscenters zum Instanziieren und Verwenden dieser Schnittstelle zusammengefasst.

  1. Sync Center erstellt einen separaten Thread für den UI-Vorgang.
  2. Sync Center erstellt eine neue instance des Handlers.
  3. Wenn der Vorgang nur einen Handler umfasst, ruft das Sync Center ISyncMgrHandler::GetObject mit der entsprechenden SYNCMGR_OBJECTID-Objekt-ID auf, um einen Zeiger auf das ISyncMgrUIOperation abzurufen, das dieses UI-Objekt implementiert. Beispielsweise ruft das Synchronisierungscenter ISyncMgrHandler::GetObject mit SYNCMGR_OBJECTID_QueryBeforeDelete auf, um ein Objekt abzurufen, das aufgerufen wird, um die Benutzeroberfläche anzuzeigen, wenn der Benutzer den Handler löschen möchte und um eine Bestätigung fragt, dass er ihn tatsächlich löschen möchte.
  4. Wenn der Vorgang ein Synchronisierungselement umfasst, führt Sync Center eine Reihe von Aufrufen aus, einschließlich der folgenden:
    1. QueryInterface wird auf der ISyncMgrHandler-Schnittstelle aufgerufen, um eine instance von ISyncMgrSyncItemContainer abzurufen.
    2. ISyncMgrSyncItemContainer::GetSyncItem wird aufgerufen, um einen Zeiger auf das ISyncMgrSyncItem-instance zu erhalten, das das Element darstellt.
    3. ISyncMgrSyncItem::GetObject wird mit der entsprechenden SYNCMGR_OBJECTID-Objekt-ID aufgerufen, um einen Zeiger auf die ISyncMgrUIOperation abzurufen, die das UI-Objekt implementiert.
  5. Sync Center ruft die Run-Methode des UI-Objekts auf, um die Benutzeroberfläche anzuzeigen.
Durch die Implementierung der Benutzeroberfläche als separate Schnittstelle kann die Anzeige der Benutzeroberfläche unabhängig von der Synchronisierung erfolgen. ISyncMgrUIOperation sollte für ein anderes Objekt als ISyncMgrHandler oder ISyncMgrSyncItem implementiert werden.

Wenn der Benutzer eine Aktion anfordert, fordert die gleiche Aktion erneut an, bevor die erste abgeschlossen ist, wird die Benutzeroberfläche für die erste Aktion aktiviert und in den Vordergrund gebracht.

Anforderungen

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