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

Chamado pelo gerenciador de sincronização em um manipulador de aplicativos registrado para determinar se o manipulador processa o evento de sincronização.

Sintaxe

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

Parâmetros

[in] dwReserved

Tipo: DWORD

Reservados; deve ser 0 (zero).

[in] dwSyncMgrFlags

Tipo: DWORD

Os valores de enumeração SYNCMGRFLAG que descrevem como um evento de sincronização é iniciado.

[in] cbCookie

Tipo: DWORD

O tamanho dos dados lpCookie , em bytes.

[in] lpCookie

Tipo: BYTE const*

Um ponteiro para o token que identifica um aplicativo. Esse token é passado quando um aplicativo invoca o gerenciador de sincronização programaticamente.

Valor retornado

Tipo: HRESULT

Esse método dá suporte aos valores de retorno padrão E_INVALIDARG, E_UNEXPECTED e E_OUTOFMEMORY e o seguinte.

Comentários

Os valores de enumeração SYNCMGRFLAG se aplicam ao longo do tempo de vida da interface ISyncMgrSynchronize e são usados pelos outros métodos ISyncMgrSynchronize .

Se um aplicativo não reconhecer o evento SYNCMGRFLAG , o aplicativo deverá tratar o evento como uma sincronização manual.

Um manipulador de aplicativo registrado não pode exibir uma interface do usuário dentro dessa chamada, a menos que seja a primeira vez que o método de inicialização é chamado. Um aplicativo pode exibir qualquer inicialização única necessária para configurar itens e introduzir um usuário em um recurso de aplicativo. Se você precisar exibir uma interface do usuário por um motivo diferente como parte do processo de sincronização, poderá usar o método ISyncMgrSynchronize::P repareForSync .

O parâmetro lpCookie é NULL , a menos que um aplicativo de manipulação invoque o gerenciador de sincronização programaticamente usando UpdateItems. Nesse cenário, o CLSID (identificador de classe) identifica o aplicativo de manipulação e o valor de lpCookie é passado pelo aplicativo de manipulação e, em seguida, passado de volta pelo gerenciador de sincronização durante a sincronização para o contexto. O parâmetro lpCookie só é significativo quando SYNCMGRFLAG_INVOKE é definido.

Requisitos

Confira também

ISyncMgrSynchronize

ISyncMgrSynchronize::P repareForSync

SYNCMGRFLAG

UpdateItems