ISyncMgrSessionCreator-Schnittstelle (syncmgr.h)

  • Artikel

Macht eine einzelne Methode verfügbar, mit der ein Handler oder eine externe Anwendung das Synchronisierungscenter über den Start der Synchronisierung benachrichtigen und Status und Ereignisse melden kann.

Vererbung

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

Methoden

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

 
ISyncMgrSessionCreator::CreateSession

Benachrichtigt das Synchronisierungscenter, dass die Synchronisierung der angegebenen Elemente begonnen hat.

Hinweise

Diese Schnittstelle wird an ISyncMgrHandler::Synchronize übergeben. Der Handler kann eine Sitzung in seiner Synchronize-Implementierung erstellen. Dies ermöglicht es dem Handler, Fortschritt und Ereignisse selbst zu melden oder einen Hintergrundprozess zu signalisieren, um Den Fortschritt und Ereignisse selbst zu melden.

Alternativ kann der Handler einem externen Prozess signalisieren, um ein CLSID_SyncMgrClient-Objekt zu erstellen. Wenn ein Handler implementiert ist, um automatische Synchronisierungen in einem externen Prozess wie z. B. einem Dienst auszuführen, muss er Statusberichte an das Synchronisierungscenter bereitstellen können, damit das Synchronisierungscenter die Benutzeroberfläche für den Benutzer aktualisieren kann. Der Handler muss auch in der Lage sein, Dem Ordner " Synchronisierungsergebnisse" des Synchronisierungscenters Ereignisse hinzuzufügen. Ein externer Prozess erstellt das CLSID_SyncMgrClient-Objekt, indem das CLSCTX_SERVER-Flag und die ISyncMgrSessionCreator IID an CoCreateInstance übergeben werden. Dies ermöglicht es diesem Prozess, Status und Ereignisse zu melden und das Synchronisierungscenter zu fragen, ob der Benutzer die Synchronisierung abgebrochen hat. Beachten Sie jedoch, dass ISyncMgrSessionCreator nicht in einen externen Prozess gemarshallt werden kann.

Anforderungen

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