<div class="content" name="RemoteConnectionParms" uuid="253af556-3edc-40d0-8ffa-5a6e23e6ecb5"><p>The RemoteConnectionParms method gets the <a href="1ef0b4e0-d88e-4b60-bc24-c983bec1e088#gt_9d7b1eb9-8131-4eb3-ad5b-08792b014893" data-linktype="relative-path">Remote Assistance connection</a>
parameters for a specific UserName, DomainName, and SessionID triple.</p><dl>
<dd>
<div><pre> [id(DISPID_PCH_SVC__REMOTECONNECTIONPARMS)] HRESULT RemoteConnectionParms(
   [in] BSTR bstrUserName,
   [in] BSTR bstrDomainName,
   [in] long lSessionID,
   [in] BSTR bstrUserHelpBlob,
   [out, retval] BSTR* pbstrConnectionString
 );
</pre></div>
</dd></dl><p><b>bstrUserName: </b>The UserName part of the
DomainName\UserName string corresponding to the <a href="1ef0b4e0-d88e-4b60-bc24-c983bec1e088#gt_ffff3f01-8c21-44d3-bbda-0062a1fbda4b" data-linktype="relative-path">terminal services</a> session
for which the client is requesting a Remote Assistance Connection String.</p><p><b>bstrDomainName: </b>The DomainName part of the
DomainName\UserName string corresponding to the terminal services session for
which the client is requesting a Remote Assistance Connection String.</p><p><b>lSessionID: </b>Identifier of the terminal
services session for which the client is requesting a Remote Assistance
Connection String.</p><p><b>bstrUserHelpBlob: </b>A semicolon-delimited string
that contains the <a href="1ef0b4e0-d88e-4b60-bc24-c983bec1e088#gt_b0276eb2-4e65-4cf1-a718-e0920a614aca" data-linktype="relative-path">domain</a>
and user names of the <a href="1ef0b4e0-d88e-4b60-bc24-c983bec1e088#gt_64520114-7ddc-4f5a-b63d-81d79b9a6693" data-linktype="relative-path">expert</a>
requesting a Remote Assistance Connection String. The format of the string is
as follows.</p><dl>
<dd>
<div><pre> &lt;Length of the string&gt;;
 &lt;&#34;UNSOLICITED=1&#34;&gt; (Note: no semicolon)
 &lt;Length of the DomainName\UserName string&gt;;
 &lt;ID=DomainName\UserName&gt;  (Note: characters &#39;ID=&#39; count toward string length)
</pre></div>
</dd></dl><p>The following is an example.</p><dl>
<dd>
<div><pre> &#34;13;UNSOLICITED=118;ID=EXDOMAIN\EXUSER&#34;
</pre></div>
</dd></dl><p><b>pbstrConnectionString:</b> A pointer to a Remote
Assistance Connection String for the requested session.</p><p><b>Return Values: </b>A signed 32-bit value
indicating return status. This method MUST return zero to indicate success, or
an <a href="../ms-dtyp/a9046ed2-bfb2-4d56-a719-2824afce59ac" data-linktype="relative-path">HRESULT</a>
error value (as specified in <a href="../ms-erref/1bc92ddf-b79e-413c-bbaa-99a5281a6c90" data-linktype="relative-path">[MS-ERREF]</a>
section <a href="../ms-erref/705fb797-2175-4a90-b5a3-3918024b10b8" data-linktype="relative-path">2.1.1</a>)
to indicate failure. If the UserName and DomainName are valid <a href="../ms-oaut/1c9d2cfc-cf7d-4f4b-95bf-584be5defd81" data-linktype="relative-path">BSTRs</a>,
the return code is one listed in the following table. If the UserName and
DomainName are invalid BSTRs, the HRESULT value returned is the corresponding
HRESULT to the system error code ERROR_NONE_MAPPED.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Return value/code</p>
   </th>
   <th>
   <p>Description</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>0x00000000 S_OK</td>
  <td>The call was successful.</td>
 </tr><tr>
  <td>0x80070005 E_ACCESSDENIED</td>
  <td>General access denied error. &lt;8&gt;</td>
 </tr><tr>
  <td>0x8007000E E_OUTOFMEMORY</td>
  <td>Out of memory.</td>
 </tr><tr>
  <td>0x800704EC ERROR_ACCESS_DISABLED_BY_POLICY</td>
  <td>The program cannot be opened because of a software restriction policy. For more information, contact the system administrator.</td>
 </tr></tbody></table>
</dd></dl><p><b>Exceptions Thrown:</b></p><p>No exceptions are thrown beyond those thrown by the
underlying <a href="1ef0b4e0-d88e-4b60-bc24-c983bec1e088#gt_8a7f6700-8311-45bc-af10-82e10accd331" data-linktype="relative-path">RPC</a> protocol <a href="../ms-rpce/290c38b1-92fe-4229-91e6-4fc376610c15" data-linktype="relative-path">[MS-RPCE]</a>.</p></div>