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

  • Artigo

Define a interface ISyncMgrSynchronizeCallback . Os aplicativos registrados usam essa interface de retorno de chamada para fornecer informações de status de dentro dos métodos ISyncMgrSynchronize::P repareForSync e ISyncMgrSynchronize::Synchronize.

Sintaxe

HRESULT SetProgressCallback(
  [in] ISyncMgrSynchronizeCallback *lpCallBack
);

Parâmetros

[in] lpCallBack

Tipo: ISyncMgrSynchronizeCallback*

Um ponteiro para a interface ISyncMgrSynchronizeCallback que o aplicativo registrado usa para fornecer comentários ao SyncMgr sobre a status de sincronização e para notificar o SyncMgr quando a sincronização for concluída.

Retornar valor

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 interface de retorno de chamada de sincronização foi definida com êxito.

Comentários

Os aplicativos registrados devem chamar o método ISyncMgrSynchronizeCallback::AddRef e usá-lo ao chamar SyncMgr para fornecer status comentários de indicadores de texto e progresso.

Se o aplicativo registrado já tiver uma interface ISyncMgrSynchronizeCallback quando o método for chamado, a interface antiga deverá ser liberada e o método AddRef da nova interface deverá ser chamado. A nova interface deve ser mantida pelo aplicativo registrado.

Antes da interface ISyncMgrSynchronize ser lançada, SyncMgr chama esse método com o parâmetro pSyncCallBack definido como NULL. Em seguida, o aplicativo registrado deve liberar a interface ISyncMgrSynchronize passada anteriormente.

Requisitos

Requisito Valor
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

Confira também

ISyncMgrSynchronize

ISyncMgrSynchronizeCallback