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

Artigo
08/24/2023

Chamado pelo gerenciador de sincronização uma vez para cada grupo selecionado depois que o usuário tiver escolhido os aplicativos registrados a serem sincronizados.

Sintaxe

HRESULT Synchronize(
  [in] HWND hWndParent
);

Parâmetros

[in] hWndParent

Digite: HWND

Um identificador para o HWND pai que o aplicativo registrado deve usar para todos os elementos de interface do usuário exibidos. Esse valor pode ser NULL.

Valor retornado

Tipo: HRESULT

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

Código de retorno	Descrição
S_OK	A sincronização foi bem-sucedida.
E_FAIL	Falha na sincronização.

Comentários

Se o usuário não selecionar nenhuma opção de item para o aplicativo registrado, o método ISyncMgrSynchronize::Synchronize não será chamado e a interface será liberada. Se esse método for chamado, o aplicativo deverá sincronizar os itens especificados no método ISyncMgrSynchronize::P repareForSync .

O manipulador do aplicativo registrado deve retornar do método ISyncMgrSynchronize::Synchronize o mais rápido possível e, em seguida, chamar o método SynchronizeCompleted . É aceitável que o manipulador chame a chamada SynchronizeCompleted antes de retornar do método ISyncMgrSynchronize::Synchronize .

O aplicativo deve fornecer comentários de progresso e marcar se a sincronização deve ser cancelada usando o ponteiro da interface pSyncCallBack que foi configurado no método ISyncMgrSynchronize::SetProgressCallback.

Os aplicativos devem fornecer informações de progresso mesmo que o sinalizador de SYNCMGRFLAG_MAYBOTHERUSER não tenha sido especificado em ISyncMgrSynchronize::Initialize.

Os aplicativos devem tentar não mostrar elementos de interface do usuário de dentro do método ISyncMgrSynchronize::Synchronize . Todos os elementos de interface do usuário devem ser mostrados nos métodos ISyncMgrSynchronize::P repareForSync e ISyncMgrSynchronize::ShowError para que o usuário final tenha uma interface de usuário consistente limitada à logon e à especificação de compartilhamentos a serem sincronizados. Posteriormente, a sincronização pode ser executada sem nenhuma intervenção do usuário. Depois que a sincronização for concluída, conflitos ou outras mensagens de erro poderão ser mostrados.

Os métodos ISyncMgrSynchronizeCallback podem ser chamados em qualquer thread em seu aplicativo.

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