<div class="content" name="PeekCurrent" uuid="388cc101-47d0-4ec3-a139-5bc2c65aabc1"><p>The PeekCurrent method is received by the server in an
RPC_REQUEST packet. In response, the server retrieves the <a href="../ms-mqdmpr/9170afda-9524-4abd-91fe-8c53e51e0def" data-linktype="relative-path">Message</a>
that is identified by the <i>Cursor</i> instance variable in the <i>referenced
queue</i>&#39;s MessagePositionList, without removing it.</p><dl>
<dd>
<div><pre> HRESULT PeekCurrent(
   [in, optional] VARIANT* WantDestinationQueue,
   [in, optional] VARIANT* WantBody,
   [in, optional] VARIANT* ReceiveTimeout,
   [in, optional] VARIANT* WantConnectorType,
   [out, retval] IMSMQMessage4** ppmsg
 );
</pre></div>
</dd></dl><p><b>WantDestinationQueue: </b>A pointer to a <a href="../ms-oaut/a6a540af-38ac-48be-bd40-92e2c01e9aa6" data-linktype="relative-path">VARIANT</a>
(VT_BOOL).</p><dl>
<dd>
<p>If this parameter is not specified by the client,
the <a href="3b7be3f7-651c-4f9c-930b-a9a7c4355ad8#gt_434b0234-e970-4e8c-bdfa-e16a30d96703" data-linktype="relative-path">server</a> MUST use the
default value VARIANT_FALSE (0x0000) in place of the unspecified value.</p>
</dd>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>VARIANT_TRUE 0xFFFF</td>
  <td>The server MUST return an MSMQMessage object that has the DestinationQueueInfo property set.</td>
 </tr><tr>
  <td>VARIANT_FALSE 0x0000</td>
  <td>Default. The server MUST return an MSMQMessage object that does not have the DestinationQueueInfo property set.</td>
 </tr></tbody></table>
</dd></dl><p><b>WantBody: </b>A pointer to a VARIANT (VT_BOOL).</p><dl>
<dd>
<p>If this parameter is not specified by the client,
the server MUST use the default value VARIANT_TRUE (0xFFFF) in place of the
unspecified value.</p>
</dd>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>VARIANT_TRUE 0xFFFF</td>
  <td>Default. The server MUST return an MSMQMessage object that has the Body property set.</td>
 </tr><tr>
  <td>VARIANT_FALSE 0x0000</td>
  <td>The server MUST return an MSMQMessage object that does not have the Body property set.</td>
 </tr></tbody></table>
</dd></dl><p><b>ReceiveTimeout: </b>A pointer to a VARIANT that
contains a long value (VT_I4) that specifies the time, in milliseconds, that
the server MUST NOT exceed while waiting for a new <a href="3b7be3f7-651c-4f9c-930b-a9a7c4355ad8#gt_85c78cf0-1fb6-4e5d-85f5-a2e9f58a6b9e" data-linktype="relative-path">message</a> to arrive.</p><dl>
<dd>
<p>If this parameter is not specified by the client,
the server MUST use the default value INFINITE (0xFFFFFFFF).</p>
</dd></dl><p><b>WantConnectorType: </b>A pointer to a VARIANT
(VT_BOOL).</p><dl>
<dd>
<p>If this parameter is not specified by the client,
the server MUST use the default value VARIANT_FALSE (0x0000) in place of the
unspecified value.</p>
</dd>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>VARIANT_TRUE 0xFFFF</td>
  <td>The server MUST return an MSMQMessage object that has the ConnectorTypeGuid property set.</td>
 </tr><tr>
  <td>VARIANT_FALSE 0x0000</td>
  <td>Default. The server MUST return an MSMQMessage object that does not have the ConnectorTypeGuid property set.</td>
 </tr></tbody></table>
</dd></dl><p><b>ppmsg: </b>A pointer to a pointer to an <a href="7e7b8992-89c1-40b9-996f-93d68bf434b3" data-linktype="relative-path">IMSMQMessage4</a> interface
that MUST be set by the server with the received message.</p><p><b>Return Values: </b>The method MUST return S_OK
(0x00000000) on success or an implementation-specific error <a href="../ms-dtyp/a9046ed2-bfb2-4d56-a719-2824afce59ac" data-linktype="relative-path">HRESULT</a>
on failure.</p><p>When processing this call, the server MUST follow these
guidelines:</p><ul><li><p><span><span> 
</span></span>If the <i>IsInitialized</i> instance variable equals False:</p>
<ul><li><p><span><span>  </span></span>Return
an error OLE_E_BLANK (0x80040007), and take no further action.</p>
</li></ul></li><li><p><span><span> 
</span></span>If the <i>IsClosed</i> instance variable equals True:</p>
<ul><li><p><span><span>  </span></span>Return
an error MQ_ERROR_INVALID_HANDLE (0xC00E0007), and take no further action.</p>
</li></ul></li><li><p><span><span> 
</span></span>If refQueue.AccessType is not equal to PeekAccess or
PeekAdminAccess or ReceiveAccess or ReceiveAdminAccess:</p>
<ul><li><p><span><span>  </span></span>Return
an error MQ_ERROR_ACCESS_DENIED (0xC00E0025), and take no further action.</p>
</li></ul></li><li><p><span><span> 
</span></span>If the <i>ppmsg</i> output parameter is NULL:</p>
<ul><li><p><span><span>  </span></span>Return
E_INVALIDARG (0x80070057), and take no further action.</p>
</li></ul></li><li><p><span><span> 
</span></span>If the message that is represented by the <i>Cursor</i> instance
variable is in the <i>MessageDeleted</i> state:</p>
<ul><li><p><span><span>  </span></span>Set
the <i>ppmsg</i> output parameter to NULL.</p>
</li><li><p><span><span>  </span></span>Return
an error MQ_ERROR_MESSAGE_ALREADY_RECEIVED (0xc00e001d), and take no further
action.</p>
</li></ul></li><li><p><span><span> 
</span></span>Define <i>suitable message</i> as a Message, identified by the <a href="3b7be3f7-651c-4f9c-930b-a9a7c4355ad8#gt_aa5e9c2d-16c1-4301-8bfe-18a0913ed275" data-linktype="relative-path">cursor</a> represented by the <i>Cursor</i>
instance variable, in the MessagePositionList of the <i>referenced queue</i>
for which the MessagePosition.State attribute does not equal Locked or
Message.AllowPeekWhenLocked equals True.</p>
</li><li><p><span><span> 
</span></span>Starting from the Message identified by the cursor that is
represented by the <i>Cursor</i> instance variable, continually advance the
cursor seeking a <i>suitable message</i>. If the cursor reaches the <i>EndQueue</i>
state, wait for more messages to arrive. Do this by raising the Peek Message
event with the following arguments:</p>
<ul><li><p><span><span>  </span></span><i>iQueueDesc</i>:
This MUST be set to the <a href="../ms-mqdmpr/e2005510-8785-414e-9a71-fa313fa6e119" data-linktype="relative-path">OpenQueueDescriptor</a>
at <i>Cursor.OpenQueueDescriptorReference</i>.</p>
</li><li><p><span><span>  </span></span><i>iTimeout</i>:
The amount of time to wait, in seconds.</p>
</li><li><p><span><span>  </span></span><i>iCursor</i>:
This MUST be set to a reference to the <i>Cursor</i> instance variable.</p>
</li><li><p><span><span>  </span></span>Based
on the rStatus, take the following actions:</p>
</li><li><p><span><span>  </span></span>If
rStatus is not MQ_OK and the <i>ReceiveTimeout</i> input parameter equals 0:</p>
<ul><li><p><span><span> 
</span></span>Set the <i>ppmsg</i> output parameter to NULL.</p>
</li><li><p><span><span> 
</span></span>Return an error MQ_ERROR_MESSAGE_NOT_FOUND (0xc00e0008), and take
no further action.</p>
</li></ul></li><li><p><span><span>  </span></span>If
rStatus is MQ_ERROR_IO_TIMEOUT, and the <i>ReceiveTimeout</i> input parameter
is greater than 0 and is not equal to INFINITE, and the time-out identified by
the <i>ReceiveTimeout</i> input parameter expires:</p>
<ul><li><p><span><span> 
</span></span>Set the <i>ppmsg</i> output parameter to NULL.</p>
</li><li><p><span><span> 
</span></span>Return an error MQ_ERROR_IO_TIMEOUT (0xc00e001b), and take no
further action.</p>
</li></ul></li><li><p><span><span>  </span></span>If
rStatus is MQ_OK:</p>
<ul><li><p><span><span> 
</span></span>Retrieve the <i>suitable message from rMessage</i>, and
instantiate an MSMQMessage instance and initialize it with the <i>suitable
message</i>, observing the requirements set forth by the <i>WantBody</i>, <i>WantDestinationQueue</i>,
and <i>WantConnectorType</i> input parameters. For details of initializing the
MSMQMessage object, refer to section <a href="9f3d4014-b019-49ea-a37e-7725b7fb20cf" data-linktype="relative-path">3.17.3</a>.</p>
</li><li><p><span><span> 
</span></span>Set the <i>ppmsg</i> output parameter to the newly instantiated
MSMQMessage instance.</p>
</li></ul></li></ul></li><li><p><span><span> 
</span></span>Return S_OK (0x00000000), and take no further action.</p>
</li></ul></div>