MessagePropertyFilter.Authenticated Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft einen Wert ab, der angibt, ob beim Einsehen oder beim Empfang einer Meldung die Authenticated-Eigenschaft abgerufen wird, oder legt diesen fest.
public:
property bool Authenticated { bool get(); void set(bool value); };
[System.Messaging.MessagingDescription("MsgAuthenticated")]
public bool Authenticated { get; set; }
[<System.Messaging.MessagingDescription("MsgAuthenticated")>]
member this.Authenticated : bool with get, set
Public Property Authenticated As Boolean
Eigenschaftswert
true
, wenn Informationen über den Authenticated abgerufen werden, andernfalls false
. Der Standardwert ist false
.
- Attribute
Beispiele
Im folgenden Codebeispiel wird die Verwendung des Authenticated-Attributs veranschaulicht.
// Set the queue's MessageReadPropertyFilter property
// to enable the message's Authenticated property.
queue->MessageReadPropertyFilter->Authenticated = true;
// Peek at the message. Time out after ten seconds
// in case the message was not delivered.
orderMessage = queue->Peek(TimeSpan::FromSeconds(10.0));
// Display the value of the message's
// Authenticated property.
Console::WriteLine("Message.Authenticated: {0}",
orderMessage->Authenticated);
// Set the queue's MessageReadPropertyFilter property to enable the
// message's Authenticated property.
queue.MessageReadPropertyFilter.Authenticated = true;
// Peek at the message. Time out after ten seconds in case the message
// was not delivered.
orderMessage = queue.Peek(TimeSpan.FromSeconds(10.0));
// Display the value of the message's Authenticated property.
Console.WriteLine("Message.Authenticated: {0}",
orderMessage.Authenticated);
Hinweise
Die Authenticated -Eigenschaft der Message -Klasse wird von der empfangenden Anwendung verwendet, um zu bestimmen, ob die Authentifizierung angefordert wurde. Wenn die Authentifizierung angefordert wurde und sich die Nachricht in der Warteschlange befindet, wird die Nachricht authentifiziert.
Es ist nicht möglich, die Eigenschaften einer Nachricht zu überprüfen und zu bestimmen, ob bei einer Nachricht ein Authentifizierungsfehler aufgetreten ist. Nachrichten, bei denen die Authentifizierung fehlschlägt, werden verworfen und nicht an die Warteschlange übermittelt.