Important: |
---|
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
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 |
Windows Embedded CE | Windows CE .NET 4.0 and later |
Windows Mobile | Windows Mobile Version 5.0 and later |