Share via


MSMQMessage.IsAuthenticated (Windows CE 5.0)

Send Feedback

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

This property is superseded by MSMQMessage.IsAuthenticated2.

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

OS Versions: Windows CE .NET 4.0 and later.
Header: Mqoai.h.
Link Library: Mqoa.lib.

See Also

MSMQMessage

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.