<div class="content" name="Transaction_Envoy_Property" uuid="f10d0768-7d29-4ced-9ef4-185f497b2af1"><p>The Transaction Envoy Property is used to notify the
unmarshaling client that the server object is running within a <a href="482ab606-0b55-4821-8b6d-d453351406c5#gt_61e1de21-a78d-4d20-b184-eda380386871" data-linktype="relative-path">transaction</a>. The server
object returns the transaction envoy context property as part of an <a href="../ms-dcom/06220154-0372-495a-bfc6-a96b804884c6" data-linktype="relative-path">OBJREF_EXTENDED</a>
instance.</p><p>The <b>policyId</b> field of the <a href="../ms-dcom/6865a1c4-f094-486e-990a-436257db57e5" data-linktype="relative-path">PROPMARSHALHEADER</a>
instance (<a href="../ms-dcom/4a893f3d-bd29-48cd-9f43-d9777a4415b0" data-linktype="relative-path">[MS-DCOM]</a>
section 2.2.20.1) for the transaction envoy property MUST be set to
guidTransactionProperty (see section <a href="738db53c-1600-432e-b288-63679b581471" data-linktype="relative-path">1.9</a>). The <b>CLSID</b>
field of the PROPMARSHALHEADER instance ([MS-DCOM] section 2.2.20.1) for the
transaction envoy property MUST be set to CLSID_TransactionEnvoy (see section
1.9).</p><p>The marshaled data buffer for the property MUST be specified
in the following format.</p><table>
 <tbody><tr>
  <th><p><br/>0</p></th>
  <th><p><br/>1</p></th>
  <th><p><br/>2</p></th>
  <th><p><br/>3</p></th>
  <th><p><br/>4</p></th>
  <th><p><br/>5</p></th>
  <th><p><br/>6</p></th>
  <th><p><br/>7</p></th>
  <th><p><br/>8</p></th>
  <th><p><br/>9</p></th>
  <th><p>1<br/>0</p></th>
  <th><p><br/>1</p></th>
  <th><p><br/>2</p></th>
  <th><p><br/>3</p></th>
  <th><p><br/>4</p></th>
  <th><p><br/>5</p></th>
  <th><p><br/>6</p></th>
  <th><p><br/>7</p></th>
  <th><p><br/>8</p></th>
  <th><p><br/>9</p></th>
  <th><p>2<br/>0</p></th>
  <th><p><br/>1</p></th>
  <th><p><br/>2</p></th>
  <th><p><br/>3</p></th>
  <th><p><br/>4</p></th>
  <th><p><br/>5</p></th>
  <th><p><br/>6</p></th>
  <th><p><br/>7</p></th>
  <th><p><br/>8</p></th>
  <th><p><br/>9</p></th>
  <th><p>3<br/>0</p></th>
  <th><p><br/>1</p></th>
 </tr>
 <tr>
  <td colspan="16">MaxVersion</td>
  <td colspan="16">MinVersion</td>
 </tr>
 <tr>
  <td colspan="32">StreamID (16 bytes)</td>
 </tr>
 <tr>
  <td colspan="32">...</td>
 </tr>
 <tr>
  <td colspan="32">...</td>
 </tr>
 <tr>
  <td colspan="32">WhereaboutsID (16 bytes)</td>
 </tr>
 <tr>
  <td colspan="32">...</td>
 </tr>
 <tr>
  <td colspan="32">...</td>
 </tr>
 <tr>
  <td colspan="16">DtcCapabilities</td>
  
 </tr>
</tbody></table><p><b>MaxVersion (2 bytes): </b>The major version number
for this Transaction Envoy property format; this field MUST be set to 0x0001.</p><p><b>MinVersion (2 bytes): </b>The minor version number
for this Transaction Envoy property format; this field MUST be set to 0x0001.</p><p><b>StreamID (16 bytes): </b> A <a href="482ab606-0b55-4821-8b6d-d453351406c5#gt_f49694cc-c350-462d-ab8e-816f0103c6c1" data-linktype="relative-path">GUID</a> that MUST contain the <a href="482ab606-0b55-4821-8b6d-d453351406c5#gt_c4eb9da7-f69b-4829-8797-5a3ff478d63d" data-linktype="relative-path">transaction stream ID</a> of
the server.</p><p><b>WhereaboutsID (16 bytes): </b> A GUID identifying
the server object&#39;s <a href="../ms-dtco/f5ab2327-10b0-469c-ac79-f35da8daa3ff" data-linktype="relative-path">SWhereabouts</a>.
For more information, see <a href="../ms-dtco/c367c571-33f3-44ac-85cb-4b9ebbb2779d" data-linktype="relative-path">[MS-DTCO]</a>.</p><p><b>DtcCapabilities (2 bytes): </b> An unsigned short
that MUST be set to one or more of the values defined in section <a href="8599ea52-f5a0-4bb3-835b-0d6409f7472d" data-linktype="relative-path">2.2.6.1</a>.</p></div>