Método ObjectContext::SetAbort (comsvcs.h)

Declara que a transação na qual o objeto está sendo executado deve ser anulada e que o objeto deve ser desativado no retorno.

Sintaxe

HRESULT SetAbort();

Retornar valor

Esse método pode retornar os valores retornados padrão E_INVALIDARG, E_OUTOFMEMORY e E_FAIL, bem como os valores a seguir.

Código de retorno	Descrição
S_OK	O método foi concluído com sucesso.
E_UNEXPECTED	Ocorreu um erro inesperado. Isso pode acontecer se um objeto passar seu ponteiro ObjectContext para outro objeto e o outro objeto chamar SetAbort usando esse ponteiro. Um ponteiro ObjectContext não é válido fora do contexto do objeto que o obteve originalmente.

Comentários

O objeto é desativado automaticamente no retorno do método no qual chamou SetAbort. Se o objeto for a raiz de uma transação automática, COM+ anulará a transação. Se o objeto for transacional, mas não a raiz de uma transação automática, a transação na qual ele está participando estará condenada à anulação.

Você pode chamar SetAbort em manipuladores de erros para garantir que uma transação seja anulada quando ocorrer um erro. Você também pode chamar SetAbort no início de um método para impedir que seu objeto se confirme prematuramente no caso de um retorno inesperado e, se tudo correr bem, chame SetComplete pouco antes do método retornar.

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	comsvcs.h

Confira também

Objectcontext