| Previous | Next |
| XACT_E_TIP_PROTOCOL_ERROR | XACT_E_DEST_TMNOTAVAILABLE |
XACT_E_TIP_PULL_FAILED
XACT_E_TIP_PULL_FAILED is the failure HRESULT 0x8004D021 (signed decimal -2147168223, unsigned decimal 2147799073). Its severity bit is 1, facility is 4 (FACILITY_ITF), and the facility-specific code field is 0xD021.
The TIP peer was reachable, but the remote transaction could not be pulled
This HRESULT reports that the transaction manager could not propagate a transaction from another TIP transaction manager. The operation is a pull of an existing remote transaction into the local transaction environment, not creation of an unrelated local unit of work.
AllStat records the Windows message as: “This transaction manager could not propagate a transaction from another TIP transaction manager.” This text should be interpreted at the transaction stage described below rather than as a generic COM failure.
The contract boundary to identify
A pull requires a valid TIP transaction URL, a live remote transaction, compatible policy, and a local object able to represent the imported transaction. Failure can therefore occur after basic connectivity succeeds but before the caller receives a usable local transaction context.
Likely causes to separate
- The supplied TIP transaction URL is stale, malformed for the peer, or refers to a transaction that has ended.
- The remote manager refuses the pull because of policy, ownership, or transaction state.
- The local TIP helper cannot convert the peer transaction into the expected local transaction object.
- Communication is lost during the pull after the initial connection has already succeeded.
Evidence worth preserving
- Record a sanitized TIP URL, local and remote manager identities, UOW mapping, and pull start time.
- Capture whether connection establishment succeeded and which pull callback or completion path reported failure.
- Obtain the peer transaction status before assuming the operation may be repeated.
- Preserve TIP and OleTx traces for the same correlation identifier.
Diagnostic sequence
- Validate that the TIP URL was obtained from the active transaction and has not been cached beyond its lifetime.
- Confirm that the peer still owns an active or recoverable transaction eligible for pull.
- Check TIP enablement and security policy on both sides even when the transport connection is open.
- Separate failure to create the local transaction representation from failure to contact the peer.
Retry and recovery
Resolve the URL, policy, state, or communication cause and pull only a transaction whose remote outcome is still known. If the peer has completed the transaction, reconcile that outcome rather than creating a new local transaction and assuming equivalence.
What this HRESULT does not establish
The code does not say that the TIP service is disabled; that has its own HRESULT. It also does not establish that the remote transaction aborted, committed, or remains in doubt.
Difference from nearby transaction results
XACT_E_TIP_CONNECT_FAILED identifies failure to establish the peer connection. XACT_E_NOIMPORTOBJECT concerns absence of a local DTC import object for cookie-based propagation.
Practical scenario
An application stores a TIP URL and attempts to pull it after a long queue delay. The remote transaction has already completed, so propagation fails. The design is changed to pull immediately and persist the resulting outcome rather than retaining transaction URLs as durable work items.
Guidance for software and telemetry
Treat transaction URLs as short-lived capabilities. Telemetry should record their source and age while hashing or redacting sensitive parts.
Official Microsoft references
- Microsoft: COM transaction error codes
- Microsoft: OleTx TIP protocol
- Microsoft: bring your own DTC or TIP transaction
- Microsoft: DTC interfaces
- Microsoft: HRESULT values in MS-ERREF
Looking for a different code? Search another status or error code.