Método IReconcileInitiator::SetProgressFeedback (reconcil.h)
Indica a quantidade de progresso que o reconciliador de maleta fez para concluir a reconciliação. O valor é uma fração e é calculado como o quociente dos parâmetros ulProgress e ulProgressMax . Reconciliadores devem chamar esse método periodicamente durante o processo de reconciliação.
Sintaxe
HRESULT SetProgressFeedback(
ULONG ulProgress,
ULONG ulProgressMax
);
Parâmetros
ulProgress
Tipo: ULONG
O numerador da fração de progresso.
ulProgressMax
Tipo: ULONG
O denominador da fração de progresso.
Retornar valor
Tipo: HRESULT
Retorna o valor S_OK se tiver êxito ou o valor E_UNEXPECTED se ocorreu um erro não especificado.
Comentários
O iniciador normalmente usa essa medida de progresso para atualizar um medidor de termômetro ou alguma outra forma de comentários visuais para o usuário. O reconciliador de pasta pode alterar o valor de ulProgressMax de chamada para chamada. Isso significa que chamadas sucessivas para esse método não indicam necessariamente progresso constante no futuro. O progresso para trás é legal, embora não desejável. É responsabilidade do iniciador determinar se o progresso com versões anteriores deve ser revelado ao usuário.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows XP [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 | reconcil.h |
DLL | Shell32.dll (versão 4.0 ou posterior) |