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 |
---|---|
|
O método foi concluído com sucesso. |
|
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 |