The Peek method is received by the server in an RPC_REQUEST packet. In response, the server retrieves the Message at the head of the referenced queue's MessagePositionList without removing it.

 HRESULT Peek(
   [in, optional] VARIANT* WantDestinationQueue,
   [in, optional] VARIANT* WantBody,
   [in, optional] VARIANT* ReceiveTimeout,
   [in, optional] VARIANT* WantConnectorType,
   [out, retval] IMSMQMessage4** ppmsg
 );

WantDestinationQueue: A pointer to a VARIANT (VT_BOOL).

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.

Value	Meaning
VARIANT_TRUE 0xFFFF	The server MUST return an MSMQMessage object that has the DestinationQueueInfo property set.
VARIANT_FALSE 0x0000	Default. The server MUST return an MSMQMessage object that does not have the DestinationQueueInfo property set.

WantBody: A pointer to a VARIANT (VT_BOOL).

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.

Value	Meaning
VARIANT_TRUE 0xFFFF	Default. The server MUST return an MSMQMessage object that has the Body property set.
VARIANT_FALSE 0x0000	The server MUST return an MSMQMessage object that does not have the Body property set.

ReceiveTimeout: 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 message to arrive.

If this parameter is not specified by the client, the server MUST use the default value INFINITE (0xFFFFFFFF).

WantConnectorType: A pointer to a VARIANT (VT_BOOL).

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.

Value	Meaning
VARIANT_TRUE 0xFFFF	The server MUST return an MSMQMessage object that has the ConnectorTypeGuid property set.
VARIANT_FALSE 0x0000	Default. The server MUST return an MSMQMessage object that does not have the ConnectorTypeGuid property set.

ppmsg: A pointer to a pointer to an IMSMQMessage4 interface that MUST be set by the server with the received message.

Return Values: The method MUST return S_OK (0x00000000) on success or an implementation-specific error HRESULT on failure.

When processing this call, the server MUST follow these guidelines:

• If the IsInitialized instance variable equals False:

  • Return an error OLE_E_BLANK (0x80040007), and take no further action.

• If the IsClosed instance variable equals True:

  • Return an error MQ_ERROR_INVALID_HANDLE (0xC00E0007), and take no further action.

• If refQueue.AccessType is not equal to PeekAccess or PeekAdminAccess or ReceiveAccess or ReceiveAdminAccess:

  • Return an error MQ_ERROR_ACCESS_DENIED (0xC00E0025), and take no further action.

• If the ppmsg output parameter is NULL:

  • Return E_INVALIDARG (0x80070057), and take no further action.

• Define suitable message as the first Message from the head of the MessagePositionList of the referenced queue for which the MessagePosition.State attribute does not equal Locked or Message.AllowPeekWhenLocked equals True.

• Attempt to retrieve the suitable message by raising the Peek Message event with the following arguments:

• iQueueDesc: This MUST be set to the OpenQueueDescriptor for the referenced queue.

• iTimeout: The amount of time to wait, in seconds.

• iCursor: This MUST be set to a reference to the Cursor instance variable.

• Based on the rStatus, take the following actions:

  • If the rStatus is not MQ_OK:

    • If the ReceiveTimeout input parameter is 0:

      • Set the ppmsg output parameter to NULL.

      • Return MQ_ERROR_MESSAGE_NOT_FOUND (0xc00e0008), and take no further action.

    • If the ReceiveTimeout input parameter is INFINITE (0xFFFFFFFF):

      • Block this call until a suitable message is available.

      • Retrieve the suitable message, and instantiate an MSMQMessage instance and initialize it with the suitable message, observing the requirements set forth by the WantBody, WantDestinationQueue, and WantConnectorType input parameters. For details of initializing the MSMQMessage object, refer to section 3.17.3.

      • Set the ppmsg output parameter to the newly instantiated MSMQMessage instance.

    • If the ReceiveTimeout input parameter is neither 0 nor INFINITE (0xFFFFFFFF):

      • Block the call until either of the following events occurs:

        • rStatus is MQ_ERROR_IO_TIMEOUT:

          • Set the ppmsg output parameter to NULL.

          • Return MQ_ERROR_IO_TIMEOUT (0xc00e001b), and take no further action.

        • rStatus is MQ_OK:

          • Retrieve the suitable message, and instantiate an MSMQMessage instance and initialize it with the suitable message, observing the requirements set forth by the WantBody, WantDestinationQueue, and WantConnectorType input parameters. For details of initializing the MSMQMessage object, refer to section 3.17.3.

          • Set the ppmsg output parameter to the newly instantiated MSMQMessage instance.

  • Else, one or more suitable messages are available:

    • Retrieve the suitable message from rMessage, and instantiate an MSMQMessage instance and initialize it with the suitable message, observing the requirements set forth by the WantBody, WantDestinationQueue, and WantConnectorType input parameters. For details of initializing the MSMQMessage object, refer to section 3.17.3.

    • Set the ppmsg output parameter to the newly instantiated MSMQMessage instance.

• Return S_OK (0x00000000), and take no further action.