Compartilhar via


Método ObjectContext::D isableCommit (comsvcs.h)

Declara que as atualizações transacionais do objeto são inconsistentes e não podem ser confirmadas em seu estado atual.

Sintaxe

HRESULT DisableCommit();

Valor retornado

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. As atualizações transacionais do objeto não podem ser confirmadas até que o objeto chame EnableCommit ou SetComplete.
E_UNEXPECTED
Ocorreu um erro inesperado. Isso pode acontecer se um objeto passar seu ponteiro ObjectContext para outro objeto e o outro objeto chamar DisableCommit usando esse ponteiro. Um ponteiro ObjectContext não é válido fora do contexto do objeto que o obteve originalmente.
CONTEXT_E_NOCONTEXT
O objeto atual não tem um contexto associado a ele. Isso provavelmente ocorre porque ele não foi criado com um dos métodos COM+ CreateInstance .

Comentários

Você pode usar o método DisableCommit para impedir que uma transação confirme prematuramente entre chamadas de método em um objeto com estado. Quando um objeto invoca DisableCommit, ele indica que seu trabalho é inconsistente e que não pode concluir seu trabalho até receber outras invocações de método do cliente. Ele também indica que precisa manter seu estado para executar esse trabalho. Isso impede que o COM+ desative o objeto e recupere seus recursos no retorno de uma chamada de método. Quando um objeto tiver chamado DisableCommit, se um cliente tentar confirmar a transação antes que o objeto tenha chamado EnableCommit ou SetComplete, a transação será anulada.

Requisitos

   
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