Método ISyncMgrSynchronize::P repareForSync (mobsync.h)

Artículo
03/15/2023

Permite que una aplicación registrada muestre cualquier interfaz de usuario y realice cualquier inicialización necesaria antes de llamar al método ISyncMgrSynchronize::Synchronize . Por ejemplo, una aplicación como el cliente de correo electrónico de Microsoft Outlook puede necesitar mostrar el cuadro de diálogo contraseña para permitir que un usuario inicie sesión en un servidor de correo.

Sintaxis

HRESULT PrepareForSync(
  [in] ULONG cbNumItems,
  [in] GUID  *pItemIDs,
  [in] HWND  hWndParent,
  [in] DWORD dwReserved
);

Parámetros

[in] cbNumItems

Tipo: ULONG

Número de elementos de la matriz a los que apunta pItemIDs.

[in] pItemIDs

Tipo: GUID*

Matriz de identificadores de elemento que un usuario elige sincronizar.

[in] hWndParent

Tipo: HWND

Identificador del HWND primario que debe usar una aplicación registrada para cualquier elemento de interfaz de usuario mostrado. Este valor puede ser NULL.

[in] dwReserved

Tipo: DWORD

Reservado. Las aplicaciones registradas deben omitir este valor.

Valor devuelto

Tipo: HRESULT

Este método admite los valores devueltos estándar E_INVALIDARG, E_UNEXPECTED y E_OUTOFMEMORY, y lo siguiente:

Código devuelto	Descripción
S_OK	La preparación es correcta.

Comentarios

Un controlador de aplicación registrado debe volver de este método lo antes posible y, a continuación, llamar al método PrepareForSyncCompleted . Un controlador de aplicación registrado puede llamar al método PrepareForSyncCompleted antes de devolverlo desde este método.

Las aplicaciones registradas solo deben mostrar una interfaz de usuario si la marca de SYNCMGRFLAG_MAYBOTHERUSER está establecida en el parámetro dwSyncFlags del método ISyncMgrSynchronize::Initialize. Si una aplicación registrada no se puede preparar para la sincronización sin mostrar una interfaz de usuario cuando no se establece la marca de SYNCMGRFLAG_MAYBOTHERUSER , debe devolver S_FALSE de este método.

La matriz de identificadores de elemento que se pasan a este método es relevante para el método ISyncMgrSynchronize::Synchronize .

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

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