Partilhar via


MessageQueue.Authenticate Propriedade

Definição

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 aceitar apenas mensagens autenticadas; caso contrário, false. O padrão é false.

Atributos

Exceções

Ocorreu um erro ao acessar um método 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.

Quando você define 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 da mensagem, um aplicativo de envio pode definir a AcknowledgeType propriedade da mensagem. Como não existe nenhuma outra indicação de rejeição de mensagem, 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 Sim
Nome do computador local e do formato direto Sim
Computador remoto No
Computador remoto e nome do formato direto No

Aplica-se a

Confira também