MessageQueue.Authenticate Propiedad

Definición

Obtiene o establece un valor que indica si la cola acepta únicamente mensajes autenticados.Gets or sets a value that indicates whether the queue accepts only authenticated messages.

public:
 property bool Authenticate { bool get(); void set(bool value); };
[System.Messaging.MessagingDescription("MQ_Authenticate")]
public bool Authenticate { get; set; }
member this.Authenticate : bool with get, set
Public Property Authenticate As Boolean

Valor de propiedad

Es true si la cola acepta sólo mensajes autenticados; en caso contrario, es false.true if the queue accepts only authenticated messages; otherwise, false. De manera predeterminada, es false.The default is false.

Atributos

Excepciones

Error al obtener acceso a un método de Message Queuing.An error occurred when accessing a Message Queuing method.

Ejemplos

En el ejemplo de código siguiente se obtiene y se establece el valor de Authenticate la propiedad de una cola de mensajes.The following code example gets and sets the value of a message queue's Authenticate property.

// 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);

Comentarios

La autenticación de mensajes proporciona una manera de garantizar la integridad del mensaje y comprobar quién lo envió.Message authentication provides a way to ensure message integrity and to verify who sent the message. Para solicitar la autenticación, la aplicación de envío establece el nivel de autenticación del mensaje.To request authentication, the sending application sets the message's authentication level.

Cuando se establece Authenticate en true, se restringe el acceso a la cola en el servidor, no solo a esta MessageQueue instancia.When you set Authenticate to true, you are restricting access to the queue on the server, not only to this MessageQueue instance. Todos los clientes que trabajan en la misma cola de Message Queue Server se verán afectados.All clients working against the same Message Queuing queue will be affected.

Una cola que acepte solo mensajes autenticados rechazará un mensaje no autenticado.A queue that accepts only authenticated messages will reject a non-authenticated message. Para solicitar la notificación del rechazo de mensajes, una aplicación emisora AcknowledgeType puede establecer la propiedad del mensaje.To request notification of message rejection, a sending application can set the AcknowledgeType property of the message. Dado que no existe ninguna otra indicación del rechazo del mensaje, la aplicación emisora puede perder el mensaje a menos que solicite que se envíe a la cola de mensajes no enviados.Because no other indication of message rejection exists, the sending application can lose the message unless you request that it be sent to the dead-letter queue.

En la tabla siguiente se muestra si esta propiedad está disponible en varios modos de grupo de trabajo.The following table shows whether this property is available in various Workgroup modes.

Modo de grupo de trabajoWorkgroup mode DisponibleAvailable
Equipo localLocal computer Yes
Equipo local y nombre de formato directoLocal computer and direct format name Yes
Equipo remotoRemote computer NoNo
Equipo remoto y nombre de formato directoRemote computer and direct format name NoNo

Se aplica a

Consulte también: