IContextState::GetMyTransactionVote method (comsvcs.h)

Article
02/22/2024

Retrieves the value of the consistent flag. Retrieving this value before deactivating the object allows the object to confirm its vote.

Syntax

HRESULT GetMyTransactionVote(
  [out] TransactionVote *ptxVote
);

Parameters

[out] ptxVote

The consistent flag. For a list of values, see the TransactionVote enumeration. This parameter is set to TxCommit if the consistent flag is true; it is set to TxAbort if the consistent flag is false.

Return value

This method can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following values.

Return code	Description
S_OK	The method completed successfully.
CONTEXT_E_NOTRANSACTION	The object is not running in a transaction.

Remarks

If the method fails, you may be able to determine that a transaction is not present, based on the HRESULT value. If the method succeeds, it returns a value based on the consistent flag. From this value, you can determine whether the object can be committed or must be aborted. Regardless of the object's state, the object must be participating in a transaction.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	comsvcs.h