2.2.6.1 Connection Types

The CONNTYPE enumeration defines the connection types that are used by MSDTC Connection Manager: OleTx Multiplexing Protocol Specification [MS-CMP].

 typedef  enum 
 {
   CONNTYPE_TXUSER_BEGINNER = 0x00000001,
   CONNTYPE_TXUSER_IMPORT = 0x00000002,
   CONNTYPE_TXUSER_ENLISTMENT = 0x00000003,
   CONNTYPE_TXUSER_EXPORT = 0x00000004,
   CONNTYPE_TXUSER_RESOURCEMANAGER = 0x00000005,
   CONNTYPE_TXUSER_REENLIST = 0x00000006,
   CONNTYPE_TXUSER_RESOLVE = 0x00000007,
   CONNTYPE_TXUSER_VOTER = 0x00000009,
   CONNTYPE_TXUSER_ASSOCIATE = 0x00000011,
   CONNTYPE_TXUSER_GETTXDETAILS = 0x00000022,
   CONNTYPE_TXUSER_PHASE0 = 0x00000024,
   CONNTYPE_TXUSER_BEGIN2 = 0x00000028,
   CONNTYPE_TXUSER_IMPORT2 = 0x00000033,
   CONNTYPE_TXUSER_GETSECURITYFLAGS = 0x00000035,
   CONNTYPE_TXUSER_TRACE = 0x00000036,
   CONNTYPE_TXUSER_SETTXTIMEOUT = 0x00000037,
   CONNTYPE_TXUSER_SETTXTIMEOUT2 = 0x00000038,
   CONNTYPE_TXUSER_PROMOTE = 0x00000039,
   CONNTYPE_TXUSER_EXTENDEDWHEREABOUTS = 0x0000003D,
   CONNTYPE_TXUSER_RESOURCEMANAGERINTERNAL = 0x00000046,
   CONNTYPE_TXUSER_EXPORT2 = 0x00000048,
   CONNTYPE_PARTNERTM_PROPAGATE = 0x00000101,
   CONNTYPE_PARTNERTM_REDELIVERCOMMIT = 0x00000102,
   CONNTYPE_PARTNERTM_CHECKABORT = 0x00000103,
   CONNTYPE_PARTNERTM_BRANCH = 0x00000104
 } CONNTYPE;

CONNTYPE_TXUSER_BEGINNER:  This connection type is used by applications that begin, commit, and roll back transactions.

CONNTYPE_TXUSER_IMPORT:  This connection type is used by a destination application to complete a Push Propagation that is initiated by a source application.

CONNTYPE_TXUSER_ENLISTMENT:  This connection type is used by a durable resource manager to establish an enlistment with its transaction manager.

CONNTYPE_TXUSER_EXPORT:  This connection type is used by a source application to initiate a push propagation to a destination application.

CONNTYPE_TXUSER_RESOURCEMANAGER:  This connection type is used by a durable resource manager to register with its transaction manager.

CONNTYPE_TXUSER_REENLIST:  This connection type is used by a durable resource manager to determine the outcome of an In Doubt transaction.

CONNTYPE_TXUSER_RESOLVE:  This connection type is used by an application either to manually resolve the outcome of an In Doubt transaction or to cause its transaction manager to forget a transaction that is in the Failed to Notify state.

CONNTYPE_TXUSER_VOTER:  This connection type is used by a volatile resource manager to establish a voter enlistment with its transaction manager.

CONNTYPE_TXUSER_ASSOCIATE:  This connection type is used by a destination application to complete the pull propagation of a transaction from a source application.

CONNTYPE_TXUSER_GETTXDETAILS:  This connection type is used by an application to retrieve details about a transaction from its transaction manager.

CONNTYPE_TXUSER_PHASE0:  This connection type is used by a resource manager to enlist for Phase Zero notifications from its transaction manager.

CONNTYPE_TXUSER_BEGIN2:  This connection type is used by an application to begin, commit, or roll back a transaction or to change the time-out of a transaction. This connection type supersedes CONNTYPE_TXUSER_BEGINNER and CONNTYPE_TXUSER_SETTXTIMEOUT2.

CONNTYPE_TXUSER_IMPORT2:  This connection type is used by a destination application to complete a Push Propagation that is initiated by a source application. This connection type supersedes CONNTYPE_TXUSER_IMPORT.

CONNTYPE_TXUSER_GETSECURITYFLAGS:  This connection type is used by an application to obtain the security configuration of its transaction manager.

CONNTYPE_TXUSER_TRACE:  This connection type is used by an application to ask its transaction manager to trace the status of a transaction by using an implementation-specific mechanism.

CONNTYPE_TXUSER_SETTXTIMEOUT:  This connection type is used by an application to modify the time-out of a transaction.

CONNTYPE_TXUSER_SETTXTIMEOUT2:  This connection type is used by an application to query the transaction manager's support for modifying the time-out of a transaction.

CONNTYPE_TXUSER_PROMOTE:  This connection type is used by an application to:

  • Begin a transaction using an application-specified transaction identity

  • Commit or rollback a transaction

  • Change the time-out of a transaction

    This connection type supersedes CONNTYPE_TXUSER_SETTXTIMEOUT2.

CONNTYPE_TXUSER_EXTENDEDWHEREABOUTS:  This connection type is used by an application to obtain Extended Whereabouts from its transaction manager.

CONNTYPE_TXUSER_RESOURCEMANAGERINTERNAL:  This connection type is used by a durable resource manager to register with a transaction manager and to detect duplicate registrations. This connection type supersedes CONNTYPE_TXUSER_RESOURCEMANAGER.

CONNTYPE_TXUSER_EXPORT2:  This connection type is used by a source application to initiate a push propagation to a destination application. This connection type supersedes CONNTYPE_TXUSER_EXPORT.

CONNTYPE_PARTNERTM_PROPAGATE:  This connection type is used by a superior transaction manager to do a push propagation of a transaction to its subordinate transaction manager and to execute the Two-Phase Commit Protocol.

CONNTYPE_PARTNERTM_REDELIVERCOMMIT:  This connection type is used by a superior transaction manager to redeliver a Commit notification for a transaction to its subordinate transaction manager.

CONNTYPE_PARTNERTM_CHECKABORT:  This connection type is used by a subordinate transaction manager to query the outcome of a transaction from its superior transaction manager.

CONNTYPE_PARTNERTM_BRANCH:  A subordinate transaction manager uses this connection type to register a new subordinate enlistment with a superior transaction manager.