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

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