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 свойство сообщения. Так как других признаков отклонения сообщения не существует, отправляющее приложение может потерять сообщение, если вы не запросите его отправку в очередь недоставленных сообщений.

В следующей таблице показано, доступно ли это свойство в различных режимах рабочей группы.

Режим рабочей группы Доступно
Локальный компьютер Да
Имя локального компьютера и прямого формата Да
Удаленный компьютер Нет
Имя удаленного компьютера и прямого формата Нет

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

См. также раздел