MSMQMessage.IsAuthenticated (Compact 2013)

3/26/2014

This read-only property indicates whether the sending application requested authentication.

This property is superseded by MSMQMessage.IsAuthenticated2.

Syntax

HRESULT get_IsAuthenticated( 
  Boolean* pIsAuthenticated 
);

Parameters

  • pIsAuthenticated
    Value that indicates whether the sending application requested authentication. The following table shows the possible values.

    Value

    Description

    1

    The sending application requested authentication.

    The receiving queue manager authenticated the message when it received the message.

    0

    The sending application did not request authentication.

    The receiving queue manager did not attempt to authenticate the message when it received the message.

Remarks

This message property is used by the receiving application only when trying to determine if authentication was requested. If authentication was requested and the message is in the queue, the message was authenticated.

Note

You cannot look at the properties of a message and determine if a message failed authentication. Messages that fail authentication are discarded and are not delivered to the queue.

Authentication requests can also be retrieved using Message Queuing function calls.

To

Set registry key to

Accept either MSMQ 1.0 or MSMQ 2.0 signatures

0

Accept only MSMQ 2.0 signatures

1

For compatibility, a source computer running MSMQ 2.0 sends, by default, only the MSMQ 1.0 signature. Therefore, when you set this receiving registry key to accept only MSMQ 2.0 signatures, reset the sending registry key on the source computer as well.

If the receiving application needs only to check whether authentication was requested, it should use IsAuthenticated. However, if the receiving application also needs to check what type of signature was used during authentication, it must use MSMQMessage.ReceivedAuthenticationLevel.

You cannot specify both message properties when reading the messages in the queue.

Requirements

Header

mqoai.h

Library

mqoa.lib

See Also

Reference

MSMQMessage