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, set
Public 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);
Комментарии
Проверка подлинности сообщений позволяет обеспечить целостность сообщений и проверить, кто отправил сообщение. Чтобы запросить проверку подлинности, отправляющее приложение задает уровень проверки подлинности сообщения.
Если задано Authenticatetrueзначение, вы ограничиваете доступ к очереди на сервере, а не только этому MessageQueue экземпляру. Все клиенты, работающие с одной очередью очереди сообщений, будут затронуты.
Очередь, принимаюющая только прошедшие проверку подлинности сообщения, отклонят не прошедшие проверку подлинности. Чтобы запросить уведомление об отклонении сообщения, отправляющее приложение может задать AcknowledgeType свойство сообщения. Поскольку нет других признаков отклонения сообщения, отправляющее приложение может потерять сообщение, если вы не запросите, что оно будет отправлено в очередь недоставленных писем.
В следующей таблице показано, доступно ли это свойство в различных режимах рабочей группы.
| Режим рабочей группы | В наличии |
|---|---|
| Локальный компьютер | Да |
| Имя локального компьютера и прямого формата | Да |
| Удаленный компьютер | Нет |
| Имя удаленного компьютера и прямого формата | Нет |