MessageQueue.Authenticate MessageQueue.Authenticate MessageQueue.Authenticate MessageQueue.Authenticate Property

Определение

Получает или задает значение, показывающее, принимает ли очередь только сообщения, прошедшие проверку подлинности.Gets or sets a value that indicates whether the queue accepts only authenticated messages.

public:
 property bool Authenticate { bool get(); void set(bool value); };
[System.Messaging.MessagingDescription("MQ_Authenticate")]
public bool Authenticate { get; set; }
member this.Authenticate : bool with get, set
Public Property Authenticate As Boolean

Значение свойства

Значение true, если очередь принимает только сообщения, прошедшие проверку подлинности; в противном случае — значение false.true if the queue accepts only authenticated messages; otherwise, false. Значение по умолчанию — false.The default is false.

Исключения

При обращении к методу службы очереди сообщений возникла ошибка.An error occurred when accessing a Message Queuing method.

Примеры

В следующем примере кода получается и задается значение Authenticate свойства очереди сообщений.The following code example gets and sets the value of a message queue's Authenticate property.

// 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);

Комментарии

Проверка подлинности сообщений позволяет обеспечить целостность сообщений и проверить, кто отправил сообщение.Message authentication provides a way to ensure message integrity and to verify who sent the message. Чтобы запросить проверку подлинности, отправляющее приложение устанавливает уровень проверки подлинности сообщения.To request authentication, the sending application sets the message's authentication level.

Если задано Authenticate значение true, доступ к очереди на сервере ограничен, а не только с этим MessageQueue экземпляром.When you set Authenticate to true, you are restricting access to the queue on the server, not only to this MessageQueue instance. Все клиенты, работающие с одной и той же очередью очереди сообщений, будут затронуты.All clients working against the same Message Queuing queue will be affected.

Очередь, принимающая только сообщения, прошедшие проверку подлинности, отклоняет сообщение без проверки подлинности.A queue that accepts only authenticated messages will reject a non-authenticated message. Чтобы запросить уведомление о отклонении сообщений, в отправляющем приложении может быть AcknowledgeType задано свойство сообщения.To request notification of message rejection, a sending application can set the AcknowledgeType property of the message. Поскольку никакое другое указание о отклонении сообщений не существует, отправляющее приложение может потерять сообщение, если только не запрашивается его отправка в очередь недоставленных сообщений.Because no other indication of message rejection exists, the sending application can lose the message unless you request that it be sent to the dead-letter queue.

В следующей таблице показано, доступно ли это свойство в различных режимах рабочей группы.The following table shows whether this property is available in various Workgroup modes.

Режим рабочей группыWorkgroup mode ДоступноAvailable
Локальный компьютерLocal computer ДаYes
Локальный компьютер и прямое имя форматаLocal computer and direct format name ДаYes
Удаленный компьютерRemote computer НетNo
Удаленный компьютер и прямое имя форматаRemote computer and direct format name НетNo

Применяется к

Дополнительно