MessageQueue.Authenticate Propriedade

Definição

Recebe 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 de Propriedade

true se a fila aceitar apenas mensagens autenticadas; caso contrário, false. A predefinição é false.

Atributos

Exceções

Ocorreu um erro ao aceder a um método de Fila de Mensagens.

Exemplos

O seguinte exemplo de código obtém e define o valor da propriedade de Authenticate uma fila de 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);

Observações

A autenticação de mensagens fornece uma forma de garantir a integridade da mensagem e de verificar quem enviou a mensagem. Para solicitar autenticação, a aplicação de envio define o nível de autenticação da mensagem.

Quando defines Authenticate para true, estás a restringir o acesso à fila no servidor, não só a esta MessageQueue instância. Todos os clientes que trabalham contra a mesma fila de Fila de Mensagens serão afetados.

Uma fila que aceita apenas mensagens autenticadas rejeitará uma mensagem não autenticada. Para solicitar notificação de rejeição de mensagem, uma aplicação remetente pode definir a AcknowledgeType propriedade da mensagem. Como não existe outra indicação de rejeição de mensagem, a aplicação de envio pode perder a mensagem a menos que solicite que seja enviada para a fila de cartas mortas.

A tabela seguinte mostra se esta propriedade está disponível em vários modos de Grupo de Trabalho.

Modo de grupo de trabalho Available
Computador local Yes
Computador local e nome do formato direto Yes
Computador remoto No
Computador remoto e nome do formato direto No

Aplica-se a

Ver também