ISyncMgrSynchronize::SetProgressCallback-Methode (mobsync.h)

Legt die ISyncMgrSynchronizeCallback-Schnittstelle fest. Registrierte Anwendungen verwenden diese Rückrufschnittstelle, um status Informationen aus den Methoden ISyncMgrSynchronize::P repareForSync und ISyncMgrSynchronize::Synchronize zu geben.

Syntax

HRESULT SetProgressCallback(
  [in] ISyncMgrSynchronizeCallback *lpCallBack
);

Parameter

[in] lpCallBack

Typ: ISyncMgrSynchronizeCallback*

Ein Zeiger auf die ISyncMgrSynchronizeCallback-Schnittstelle, die die registrierte Anwendung verwendet, um SyncMgr Feedback zur Synchronisierung status zu geben und SyncMgr zu benachrichtigen, wenn die Synchronisierung abgeschlossen ist.

Rückgabewert

Typ: HRESULT

Diese Methode unterstützt die Standardrückgabewerte E_INVALIDARG, E_UNEXPECTED und E_OUTOFMEMORY sowie Folgendes:

Rückgabecode	BESCHREIBUNG
S_OK	Die Synchronisierungsrückrufschnittstelle wurde erfolgreich festgelegt.

Hinweise

Registrierte Anwendungen müssen die ISyncMgrSynchronizeCallback::AddRef-Methode aufrufen und beim Aufrufen von SyncMgr verwenden, um status Text- und Statusindikatorfeedback bereitzustellen.

Wenn die registrierte Anwendung bereits über eine ISyncMgrSynchronizeCallback-Schnittstelle verfügt, wenn die Methode aufgerufen wird, muss die alte Schnittstelle freigegeben und die AddRef-Methode der neuen Schnittstelle aufgerufen werden. Die neue Schnittstelle muss von der registrierten Anwendung verwaltet werden.

Bevor die ISyncMgrSynchronize-Schnittstelle veröffentlicht wird, ruft SyncMgr diese Methode auf, wobei der pSyncCallBack-Parameter auf NULL festgelegt ist. Die registrierte Anwendung sollte dann die zuvor übergebene ISyncMgrSynchronize-Schnittstelle freigeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mobsync.h
DLL	Mobsync.dll

Weitere Informationen

ISyncMgrSynchronize

ISyncMgrSynchronizeCallback