Compartilhar via


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

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

Sintaxe

HRESULT SetComplete();

Retornar valor

Esse método pode retornar os valores de retorno 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 o ponteiro ObjectContext para outro objeto e o outro objeto chamar SetComplete 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 ele chamou SetComplete. Se o objeto for a raiz de uma transação automática, COM+ tentará confirmar a transação. No entanto, se qualquer objeto que estava participando da transação tiver chamado SetAbort ou tiver chamado DisableCommit e não tiver chamado EnableCommit ou SetComplete posteriormente, a transação será anulada.

Se um objeto não precisar manter seu estado após retornar de uma chamada de método, ele deverá chamar SetComplete para que ele possa ser desativado automaticamente assim que retornar e seus recursos possam ser recuperados.

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