MessageQueue.Authenticate Eigenschaft

Referenz

Definition

Namespace:: System.Messaging

Assembly:: System.Messaging.dll

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 die Warteschlange nur authentifizierte Meldungen akzeptiert, oder legt diesen fest.

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

Eigenschaftswert

Boolean

true, wenn die Warteschlange nur authentifizierte Meldungen akzeptiert, andernfalls false. Der Standardwert ist false.

Attribute: MessagingDescriptionAttribute

Ausnahmen

MessageQueueException

Fehler beim Zugriff auf eine Message Queuing-Methode.

Beispiele

Im folgenden Codebeispiel wird der Wert der -Eigenschaft einer Nachrichtenwarteschlange Authenticate abgerufen und festgelegt.

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

Hinweise

Die Nachrichtenauthentifizierung bietet eine Möglichkeit, die Nachrichtenintegrität sicherzustellen und zu überprüfen, wer die Nachricht gesendet hat. Um die Authentifizierung anzufordern, legt die sendende Anwendung die Authentifizierungsebene der Nachricht fest.

Wenn Sie auf truefestlegenAuthenticate, beschränken Sie den Zugriff auf die Warteschlange auf dem Server, nicht nur auf diese MessageQueue instance. Alle Clients, die mit derselben Message Queuing-Warteschlange arbeiten, sind betroffen.

Eine Warteschlange, die nur authentifizierte Nachrichten akzeptiert, lehnt eine nicht authentifizierte Nachricht ab. Um eine Benachrichtigung über die Ablehnung von Nachrichten anzufordern, kann eine sendende Anwendung die AcknowledgeType -Eigenschaft der Nachricht festlegen. Da kein anderer Hinweis auf die Ablehnung von Nachrichten vorhanden ist, kann die sendende Anwendung die Nachricht verlieren, es sei denn, Sie fordern an, dass sie an die Warteschlange für unzustellbare Nachrichten gesendet wird.

Die folgende Tabelle zeigt, ob diese Eigenschaft in verschiedenen Arbeitsgruppenmodi verfügbar ist.

Arbeitsgruppenmodus	Verfügbar
Lokalem Computer	Ja
Name des lokalen Computers und direktes Format	Ja
Remotecomputer	Nein
Name des Remotecomputers und des direkten Formats	Nein

Gilt für:

Freigeben über