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.
| Código de retorno | Descrição |
|---|---|
|
A inicialização foi bem-sucedida. |
|
O manipulador de aplicativos não processa um evento de sincronização. |
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
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | mobsync.h |
| DLL | Mobsync.dll |