MessageQueue.Authenticate 属性
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
获取或设置一个值，该值指示队列是否仅接受经过身份验证的消息。
public:
property bool Authenticate { bool get(); void set(bool value); };[System.Messaging.MessagingDescription("MQ_Authenticate")]
public bool Authenticate { get; set; }[<System.Messaging.MessagingDescription("MQ_Authenticate")>]
member this.Authenticate : bool with get, setPublic Property Authenticate As Boolean属性值
如果队列仅接受已经过身份验证的消息，则为 true；否则为 false。 默认值为 false。
- 属性
例外
访问“消息队列”方法时出错。
示例
下面的代码示例获取并设置消息队列的 Authenticate 属性的值。
// Set the queue's Authenticate property value.
queue.Authenticate = true;
// Display the new value of the queue's Authenticate property.
Console.WriteLine("MessageQueue.Authenticate: {0}", queue.Authenticate);
注解
消息身份验证提供了一种确保消息完整性和验证消息发送者的方法。 若要请求身份验证，发送应用程序会设置消息的身份验证级别。
设置为 Authenticate 时， true将限制对服务器上的队列的访问，而不仅仅是此 MessageQueue 实例。 针对同一消息队列工作的所有客户端都将受到影响。
仅接受经过身份验证的消息的队列将拒绝未经身份验证的消息。 若要请求消息拒绝通知，发送应用程序可以设置 AcknowledgeType 消息的 属性。 由于不存在消息拒绝的其他指示，因此除非请求将消息发送到死信队列，否则发送应用程序可能会丢失该消息。
下表显示了此属性是否在各种工作组模式下可用。
| 工作组模式 | 可用 |
|---|---|
| 本地计算机 | 是 |
| 本地计算机和直接格式名称 | 是 |
| 远程计算机 | 否 |
| 远程计算机和直接格式名称 | 否 |
