Compartir a través de

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

  • Artículo

Llamado por el administrador de sincronización en un controlador de aplicación registrado para determinar si el controlador procesa el evento de sincronización.

Sintaxis

HRESULT Initialize(
  [in] DWORD      dwReserved,
  [in] DWORD      dwSyncMgrFlags,
  [in] DWORD      cbCookie,
  [in] const BYTE *lpCookie
);

Parámetros

[in] dwReserved

Tipo: DWORD

Reservados; debe ser 0 (cero).

[in] dwSyncMgrFlags

Tipo: DWORD

Los valores de enumeración SYNCMGRFLAG que describen cómo se inicia un evento de sincronización.

[in] cbCookie

Tipo: DWORD

Tamaño de los datos lpCookie , en bytes.

[in] lpCookie

Tipo: BYTE const*

Puntero al token que identifica una aplicación. Este token se pasa cuando una aplicación invoca al administrador de sincronización mediante programación.

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 inicialización se realiza correctamente.
S_FALSE
 El controlador de aplicaciones no procesa un evento de sincronización.

Comentarios

Los valores de enumeración SYNCMGRFLAG se aplican a través de la duración de la interfaz ISyncMgrSynchronize y los usan los otros métodos ISyncMgrSynchronize .

Si una aplicación no reconoce el evento SYNCMGRFLAG , la aplicación debe tratar el evento como una sincronización manual.

Un controlador de aplicación registrado no puede mostrar una interfaz de usuario dentro de esta llamada a menos que se llame a la primera vez que se llame al método de inicialización. Una aplicación puede mostrar cualquier inicialización única que necesite para configurar elementos e introducir un usuario en una característica de aplicación. Si necesita mostrar una interfaz de usuario por otro motivo como parte del proceso de sincronización, puede usar el método ISyncMgrSynchronize::P repareForSync .

El parámetro lpCookie es NULL a menos que una aplicación de control invoque el administrador de sincronización mediante programación mediante UpdateItems. En este escenario, el identificador de clase (CLSID) identifica la aplicación de control y el valor de lpCookie se pasa mediante la aplicación de control y, a continuación, lo pasa el administrador de sincronización durante la sincronización para el contexto. El parámetro lpCookie solo es significativo cuando se establece SYNCMGRFLAG_INVOKE .

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

Consulte también

ISyncMgrSynchronize

ISyncMgrSynchronize::P repareForSync

SYNCMGRFLAG

UpdateItems