Compartilhar via


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

Indica se o objeto atual está sendo executado em uma transação.

Sintaxe

HRESULT IsInTransaction(
  [out] VARIANT_BOOL *pbIsInTx
);

Parâmetros

[out] pbIsInTx

TRUE se o objeto atual estiver sendo executado em uma transação; FALSE caso contrário.

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 seu ponteiro ObjectContext para outro objeto e o outro objeto chamar IsInTransaction usando esse ponteiro. Um ponteiro ObjectContext não é válido fora do contexto do objeto que o obteve originalmente.

Comentários

Você pode usar esse método para garantir que um objeto que requer uma transação nunca seja executado sem um. Por exemplo, se um componente que requer uma transação estiver configurado incorretamente na ferramenta de administração dos Serviços de Componentes, você poderá usar esse método para determinar que o objeto não tem uma transação. Em seguida, você pode retornar um erro para alertar o usuário sobre o problema ou tomar qualquer ação apropriada.

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