ISyncMgrControl::StartHandlerSync-Methode (syncmgr.h)

Initiiert die Synchronisierung aller Elemente, die von einem bestimmten Handler verwaltet werden.

Syntax

HRESULT StartHandlerSync(
  [in] LPCWSTR                    pszHandlerID,
  [in] HWND                       hwndOwner,
  [in] IUnknown                   *punk,
  [in] SYNCMGR_SYNC_CONTROL_FLAGS nSyncControlFlags,
  [in] ISyncMgrSyncResult         *pResult
);

Parameter

[in] pszHandlerID

Typ: LPCWSTR

Ein Zeiger auf einen Puffer, der die eindeutige ID des zu synchronisierenden Handlers enthält. Diese Zeichenfolge hat eine maximale Länge MAX_SYNCMGR_ID einschließlich des beendenden NULL-Zeichens .

[in] hwndOwner

Typ: HWND

Ein Handle für das Fenster, das der Handler verwenden kann, um jede erforderliche Benutzeroberfläche anzuzeigen. Dieser Wert kann NULL sein.

[in] punk

Typ: IUnknown*

Ein Zeiger auf eine IUnknown , die an Synchronize übergeben werden soll. Dieser Parameter kann NULL sein.

[in] nSyncControlFlags

Typ: SYNCMGR_SYNC_CONTROL_FLAGS

Ein Member der SYNCMGR_SYNC_CONTROL_FLAGS Enumeration, das angibt, ob ein Element, das sowohl in einer aktuellen Synchronisierung als auch in einer Warteschlange gefunden wurde, erneut synchronisiert werden soll, wenn die Synchronisierung in der Warteschlange ausgeführt wird.

[in] pResult

Typ: ISyncMgrSyncResult*

Ein Zeiger auf eine instance von ISyncMgrSyncResult, dessen Result-Methode aufgerufen wird, wenn die Synchronisierung beendet wird, entweder durch Erfolg, Fehler oder Abbruch. Die Result-Methode wird mit dem aggregierten Zustand der Handlersynchronisierung aufgerufen. Dieser Parameter kann NULL sein.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

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