Método IReconcileInitiator::SetAbortCallback (reconcil.h)

Define o objeto pelo qual o iniciador pode encerrar de forma assíncrona uma reconciliação. Um reconciliador de pasta normalmente define esse objeto para reconciliações que são longas ou envolvem a interação do usuário.

Sintaxe

HRESULT SetAbortCallback(
  IUnknown *punkForAbort
);

Parâmetros

punkForAbort

Tipo: IUnknown*

O endereço da interface IUnknown para o objeto . O iniciador sinaliza uma solicitação para encerrar a reconciliação usando o método IUnknown::Release para liberar o objeto. Esse parâmetro pode ser NULL para direcionar o iniciador para remover o objeto especificado anteriormente.

Valor retornado

Tipo: HRESULT

Retorna o valor S_OK se tiver êxito ou um dos valores de erro a seguir, caso contrário.

Comentários

O iniciador pode aceitar ou rejeitar o objeto. Se o iniciador aceitar o objeto, o reconciliador de pasta deverá remover o objeto chamando esse método com um parâmetro NULL quando a reconciliação for concluída. Como o reconciliador remove o objeto após concluir a reconciliação, pode haver momentos em que o iniciador libera o objeto após a conclusão da reconciliação. Nesses casos, o reconciliador ignora a solicitação para terminar.

Se a reconciliação for encerrada, o método Reconcile deverá retornar o valor REC_E_ABORTED ou REC_E_NOTCOMPLETE.

Requisitos

Confira também

IReconcileInitiator