MessageQueue.Authenticate Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает значение, показывающее, принимает ли очередь только сообщения, прошедшие проверку подлинности.
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 свойство сообщения. Поскольку нет других признаков отклонения сообщения, отправляющее приложение может потерять сообщение, если вы не запросите его отправку в очередь недоставленных сообщений.
В следующей таблице показано, доступно ли это свойство в различных режимах рабочей группы.
| Режим рабочей группы | Доступно |
|---|---|
| Локальный компьютер | Да |
| Имя локального компьютера и прямого формата | Да |
| Удаленный компьютер | Нет |
| Имя удаленного компьютера и прямого формата | Нет |