<div class="content" name="R_QMQueryQMRegistryInternal" uuid="a301e730-9c3c-4c7d-baba-6c6d0eca76f9"><p>A <a href="102555d1-0dbf-4b2e-b78c-e388823d252c#gt_60e0e1fa-66fe-41e1-b5e3-ceab97e53506" data-linktype="relative-path">client</a>
calls the R_QMQueryQMRegistryInternal method to retrieve various string values
from the <a href="102555d1-0dbf-4b2e-b78c-e388823d252c#gt_2739ef12-a749-4540-9ac3-715968ef4df4" data-linktype="relative-path">supporting server</a>.</p><dl>
<dd>
<div><pre> HRESULT R_QMQueryQMRegistryInternal(
   [in] handle_t hBind,
   [in] DWORD dwQueryType,
   [out, string] WCHAR** lplpMQISServer
 );
</pre></div>
</dd></dl><p><b>hBind: </b>MUST be set to an <a href="102555d1-0dbf-4b2e-b78c-e388823d252c#gt_8a7f6700-8311-45bc-af10-82e10accd331" data-linktype="relative-path">RPC</a> binding handle as
described in <a href="../ms-rpce/290c38b1-92fe-4229-91e6-4fc376610c15" data-linktype="relative-path">[MS-RPCE]</a>
section <a href="../ms-rpce/a01f5886-c485-4bcf-bb23-e0d755510ab7" data-linktype="relative-path">2</a>.</p><p><b>dwQueryType: </b>Specifies the type and format of
the data to return to the caller via the <i>lplpMQISServer</i> parameter. MUST
be one of the values in the following table:</p><table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>0x00000000</td>
  <td>A comma-delimited list of MQIS server names configured on the supporting server. This value is retrieved from the DirectoryServerList attribute of the server&#39;s LocalQueueManager ADM element instance.</td>
 </tr><tr>
  <td>0x00000001</td>
  <td>The server&#39;s default time-to-reach-queue message property value, expressed in seconds, converted to a string.&lt;59&gt;&lt;60&gt;</td>
 </tr><tr>
  <td>0x00000002</td>
  <td>The GUID that represents the entire MSMQ forest.&lt;61&gt; See following for the curly braced GUID string representation to use. The string uses the &#34;braceless&#34; format.</td>
 </tr><tr>
  <td>0x00000003</td>
  <td>A string representation of the supporting server version.&lt;62&gt;</td>
 </tr><tr>
  <td>0x00000004</td>
  <td>The content of the Identifier attribute of the server&#39;s LocalQueueManager ADM element instance. The curly braced GUID string representation uses a &#34;braceless&#34; format given following.&lt;63&gt;&lt;64&gt;</td>
 </tr></tbody></table><p>The format for the comma-delimited list of MQIS server names
(0x00000000) is given by the following augmented BNF:</p><dl>
<dd>
<div><pre> list = [list &#34;,&#34;] computer-name
 computer-name = 1*15digit
 digit = num-digit / uppercase-alpha-digit / lowercase-alpha-digit 
                   / special-digit
 num-digit = %x30-39
 uppercase-alpha-digit = %x41-5Alowercase-alpha-digit = %x61-7A
 special-digit = &#34;!&#34; / &#34;@&#34; / &#34;#&#34; / &#34;$&#34; / &#34;%&#34; / &#34;^&#34; / &#34;&amp;&#34; / &#34;&#39;&#34; 
                 / &#34;)&#34; / &#34;(&#34; / &#34;.&#34; / &#34;-&#34; / &#34;_&#34; / &#34;{&#34; / &#34;}&#34; / &#34;~&#34;
  
</pre></div>
</dd></dl><p>The GUID string for the MSMQ forest (0x00000002) uses the
&#34;braceless&#34; format depicted in the following augmented BNF:</p><dl>
<dd>
<div><pre>  
 braceless-guid = dword-part &#34;-&#34; word-part &#34;-&#34; word-part &#34;-&#34; 
                  2byte-part &#34;-&#34; 6byte-part
 dword-part = 2word-part
 word-part = 2byte-part
 byte-part = 2hex-digit
 hex-digit = %x30-39 / %x41-46 / %x61-66
  
</pre></div>
</dd></dl><p>The string format used for the supporting server version
(0x00000003), depicted in augmented BNF, is as follows:</p><dl>
<dd>
<div><pre>  
 version = version-part &#34;.&#34; version-part &#34;.&#34; version-part
 version-part = 1*4num-digit
 num-digit = %x30-39
</pre></div>
</dd></dl><p>The GUID for the server <a href="102555d1-0dbf-4b2e-b78c-e388823d252c#gt_476f10ed-08f0-4887-b583-59d5cf909979" data-linktype="relative-path">queue manager</a> (0x00000004)
uses the following &#34;braceless&#34; format, depicted in augmented BNF:</p><dl>
<dd>
<div><pre>  
 braceless-guid = dword-part &#34;-&#34; word-part &#34;-&#34; word-part &#34;-&#34; 
                  2byte-part &#34;-&#34; 6byte-part
 dword-part = 2word-part
 word-part = 2byte-part
 byte-part = 2hex-digit
 hex-digit = %x30-39 / %x41-46 / %x61-66
  
</pre></div>
</dd></dl><p><b>lplpMQISServer: </b> On success, the server
returns the string indicated by dwQueryType through this parameter. The server
can set this parameter to NULL in the event of an error.</p><p><b>Return Values: </b>On success, this method MUST return
MQ_OK (0x00000000).</p><p>If input parameter values violate constraints specified
above, the server MUST take no further action and return a failure <a href="../ms-dtyp/a9046ed2-bfb2-4d56-a719-2824afce59ac" data-linktype="relative-path">HRESULT</a>.</p><p>If any other error occurs, the server MUST return a failure
HRESULT, and the client MUST treat all other failure HRESULTs identically.
Additionally, if any other failure HRESULT is returned, the client MUST
disregard all out-parameter values.</p><p>Exceptions Thrown: No exceptions are thrown beyond those
thrown by the underlying RPC protocol, as specified in [MS-RPCE]. </p><p>This method is invoked at the dynamically assigned <a href="102555d1-0dbf-4b2e-b78c-e388823d252c#gt_b91c1e27-e8e0-499b-8c65-738006af72ee" data-linktype="relative-path">endpoint</a> returned by the <a href="a8c96155-a7e6-41cb-95c7-6ab7e4f8214d" data-linktype="relative-path">R_QMGetRTQMServerPort</a>
method when IP_HANDSHAKE (0x00000000) or IPX_HANDSHAKE (0x00000002) is the
interface specified by the <i>fIP</i> parameter.</p></div>