MessageQueue.Authenticate Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um valor que indica se a fila aceita apenas mensagens autenticadas.
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
Valor da propriedade
true
se a fila aceita apenas mensagens autenticadas; caso contrário, false
. O padrão é false
.
- Atributos
Exceções
Erro ao acessar um método do serviço de Enfileiramento de Mensagens.
Exemplos
O exemplo de código a seguir obtém e define o valor da propriedade de uma fila de Authenticate mensagens.
// 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);
Comentários
A autenticação de mensagem fornece uma maneira de garantir a integridade da mensagem e verificar quem enviou a mensagem. Para solicitar a autenticação, o aplicativo de envio define o nível de autenticação da mensagem.
Ao definir Authenticate como true
, você está restringindo o acesso à fila no servidor, não apenas a essa MessageQueue instância. Todos os clientes que trabalham na mesma fila de Enfileiramento de Mensagens serão afetados.
Uma fila que aceita apenas mensagens autenticadas rejeitará uma mensagem não autenticada. Para solicitar a notificação de rejeição de mensagens, um aplicativo de envio pode definir a AcknowledgeType propriedade da mensagem. Como nenhuma outra indicação de rejeição de mensagem existe, o aplicativo de envio pode perder a mensagem, a menos que você solicite que ela seja enviada para a fila de mensagens mortas.
A tabela a seguir mostra se essa propriedade está disponível em vários modos de Grupo de Trabalho.
Modo de grupo de trabalho | Disponível |
---|---|
Computador local | Yes |
Nome do computador local e do formato direto | Yes |
Computador remoto | Não |
Computador remoto e nome de formato direto | Não |