| Previous | Next |
| ERROR_TRANSACTION_SCOPE_CALLBACKS_NOT_SET | ERROR_CANNOT_EXECUTE_FILE_IN_TRANSACTION |
ERROR_TRANSACTION_REQUIRED_PROMOTION
A local transaction cannot enlist because the required promotion is forbidden
ERROR_TRANSACTION_REQUIRED_PROMOTION belongs to the Windows Kernel Transaction Manager transaction-processing model. Promotion changes a transaction from a local coordination context into one that can participate through another transaction manager or distributed protocol. MS-DTCO describes superior and subordinate branches used when coordinators associate a transaction across boundaries. A resource manager that cannot join the current local form may require promotion before it can enlist.
Identify the resource manager whose enlistment triggered promotion and the policy or transaction option that forbids it. Common architecture mistakes include opening a second durable resource under a transaction designed to remain local or crossing a process or machine boundary unexpectedly. Do not repeatedly retry enlistment: the same topology still requires promotion. Either allow and correctly configure distributed coordination, or redesign the unit of work so the additional RM participates outside that transaction.
What to inspect
- Log the RM and operation that first requires promotion.
- Check for unexpected remote, cross-process, or second-resource participation.
- Choose explicitly between enabling distributed coordination and keeping the transaction local.
References
- MS-DTCO: superior and subordinate transaction-manager roles
- MS-DTCO: subordinate branch registration and two-phase commit
- Microsoft: superior transaction managers and superior enlistments
- Microsoft: KTM programming model and transaction handles
Looking for a different code? Search another status or error code.