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 |