MessageQueueAccessControlEntry-Klasse

Artikel
08/20/2007

Gibt Zugriffsrechte für einen Vertrauensnehmer (Benutzer, Gruppe oder Computer) für die Durchführung von Message Queuing-Aufgaben an.

Namespace: System.Messaging
Assembly: System.Messaging (in system.messaging.dll)

Syntax

'Declaration
Public Class MessageQueueAccessControlEntry
    Inherits AccessControlEntry
'Usage
Dim instance As MessageQueueAccessControlEntry

public class MessageQueueAccessControlEntry : AccessControlEntry

public ref class MessageQueueAccessControlEntry : public AccessControlEntry

public class MessageQueueAccessControlEntry extends AccessControlEntry

public class MessageQueueAccessControlEntry extends AccessControlEntry

Hinweise

Geben Sie mithilfe der MessageQueueAccessControlEntry-Klasse die Rechte an, die einem Vertrauensnehmer gewährt werden sollen. Diese Rechte umfassen das Einsehen, Empfangen und Senden von Meldungen, das Anzeigen oder Ändern von Eigenschaften und Berechtigungen für Warteschlangen sowie das Löschen von Warteschlangen. Die SetPermissions-Methode der MessageQueue-Klasse stellt Überladungen für das direkte Übergeben einer Instanz dieser Klasse an die Methode oder für das Hinzufügen zu einer Instanz von AccessControlList bereit, sodass Sie Rechte für mehrere Vertrauensnehmer gleichzeitig hinzufügen können. Das neue Zugriffsrecht wird an das Ende der DACL (Discretionary Access Control List, freigegebene Zugriffssteuerungsliste) der Warteschlange angefügt, die die Benutzer und Gruppen angibt, die auf die Warteschlange zugreifen können.

Es gibt einige Ausnahmen zu diesen generellen Aussagen darüber, an welcher Stelle das neue Recht hinzugefügt wird und welche Auswirkungen es hat. Weitere Informationen finden Sie unter System.Messaging.

Mithilfe einer Überladung des MessageQueueAccessControlEntry-Konstruktors können Sie einen AccessControlEntryType-Member angeben, der angibt, ob dem Vertrauensnehmer Rechte gewährt oder verweigert werden. Die Reihenfolge, in der in der DACL der Ressource Rechte gewährt oder verweigert werden, hat Auswirkungen darauf, ob der Vertrauensnehmer über die angegebenen Rechte verfügt. Wenn dem Vertrauensnehmer z. B. bereits Rechte gewährt wurden und Sie später einen Eintrag hinzufügen, mit dem diese verweigert werden, findet das System zunächst die gewährten Rechte, sodass der Benutzer über Rechte verfügt, die ihm eigentlich verweigert werden sollten. Dieses Verhalten können Sie mit den beiden Eintragstypen Set und Revoke außer Kraft setzen. Weitere Informationen darüber, wie die Bestimmung von Zugriffsrechten gesteuert wird, finden Sie im Thema über die AccessControlEntryType-Enumeration.

Der MessageQueueAccessControlEntry-Klasse ist Sicherheit auf der Grundlage von ACLs (Access Control Lists, Zugriffssteuerungslisten) zugeordnet, über die Sie Benutzern den Zugriff auf das Message Queuing-System selbst gewähren können. Dies unterscheidet sich von der Codezugriffssicherheit, die durch die MessageQueuePermission-Klasse und verwandte Klassen implementiert wird. Die Codezugriffssicherheit für Message Queuing definiert warteschlangenspezifische Operationen oder Warteschlangenzugriff, die der Sicherheitskontrolle unterliegen und von einer Anwendung benötigt werden. Sie stellt kein Recht für die Anwendung dar, diese Operationen auszuführen oder den Zugriff selbst zu erhalten. Weitere Informationen über die Codezugriffssicherheit finden Sie im Thema Codezugriffssicherheit.

Um Berechtigungen für Meldungswarteschlangen für einen Vertrauensnehmer festzulegen, erstellen Sie eine neue Instanz der Trustee-Klasse, und übergeben Sie diese an eine Überladung des MessageQueueAccessControlEntry-Konstruktors. Geben Sie die Zugriffsrechte für die Meldungswarteschlange an, indem Sie entweder eine Instanz von MessageQueueAccessRights an den Konstruktor übergeben oder die MessageQueueAccessRights-Eigenschaft auf eine vorhandene MessageQueueAccessControlEntry-Instanz festlegen.

Sie können die MessageQueueAccessControlEntry-Instanz anschließend direkt an die MessageQueue.SetPermissions-Methode übergeben. Sie können den Eintrag aber auch einer Instanz von AccessControlList hinzufügen, bevor Sie SetPermissions aufrufen.

Vererbungshierarchie

System.Object
System.Messaging.AccessControlEntry
System.Messaging.MessageQueueAccessControlEntry

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

MessageQueueAccessControlEntry-Member
System.Messaging-Namespace
MessageQueue.SetPermissions
Trustee
AccessControlList-Klasse
AccessControlEntryType-Enumeration
MessageQueuePermission

Freigeben über