Método ISyncMgrSynchronize::Synchronize (mobsync.h)

Artículo
03/15/2023

Lo llama el administrador de sincronización una vez para cada grupo seleccionado después de que el usuario haya elegido las aplicaciones registradas que se van a sincronizar.

Sintaxis

HRESULT Synchronize(
  [in] HWND hWndParent
);

Parámetros

[in] hWndParent

Tipo: HWND

Un identificador para el HWND primario que la aplicación registrada debe usar para cualquier elemento de interfaz de usuario que muestre. Este valor puede ser NULL.

Valor devuelto

Tipo: HRESULT

Este método admite los valores devueltos estándar, E_INVALIDARG, E_UNEXPECTED y E_OUTOFMEMORY, así como los siguientes:

Código devuelto	Descripción
S_OK	La sincronización se realizó correctamente.
E_FAIL	Error de sincronización.

Comentarios

Si el usuario no selecciona ninguna opción de elemento para la aplicación registrada, no se llama al método ISyncMgrSynchronize::Synchronize y se libera la interfaz. Si se llama a este método, la aplicación debe sincronizar los elementos especificados en el método ISyncMgrSynchronize::P repareForSync .

El controlador de la aplicación registrada debe devolver desde el método ISyncMgrSynchronize::Synchronize lo antes posible y, a continuación, llamar al método SynchronizeCompleted . Es aceptable que el controlador llame a la llamada SynchronizeCompleted antes de devolver desde el método ISyncMgrSynchronize::Synchronize .

La aplicación debe proporcionar comentarios de progreso y comprobar si la sincronización debe cancelarse mediante el puntero de interfaz pSyncCallBack que se configuró en el método ISyncMgrSynchronize::SetProgressCallback .

Las aplicaciones deben proporcionar información de progreso incluso si no se especificó la marca SYNCMGRFLAG_MAYBOTHERUSER en ISyncMgrSynchronize::Initialize.

Las aplicaciones deben intentar no mostrar elementos de la interfaz de usuario desde el método ISyncMgrSynchronize::Synchronize . Los elementos de la interfaz de usuario deben mostrarse en los métodos ISyncMgrSynchronize::P repareForSync e ISyncMgrSynchronize::ShowError para que el usuario final experimente una interfaz de usuario coherente que se limita a iniciar sesión y especificar los recursos compartidos que se van a sincronizar. Posteriormente, la sincronización se puede realizar sin intervención del usuario. Una vez completada la sincronización, se pueden mostrar conflictos u otros mensajes de error.

Se puede llamar a los métodos ISyncMgrSynchronizeCallback en cualquier subproceso de la aplicación.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	mobsync.h
Archivo DLL	Mobsync.dll