MessageQueueAccessControlEntry クラス

.NET Framework クラス ライブラリ リファレンス

MessageQueueAccessControlEntry クラス

メッセージ キューのタスクを実行するトラスティ (ユーザー、グループ、またはコンピュータ) のアクセス権を指定します。

名前空間: System.Messaging
アセンブリ: System.Messaging (system.messaging.dll 内)
構文

Visual Basic (宣言)

Public Class MessageQueueAccessControlEntry
    Inherits AccessControlEntry

Visual Basic (使用法)

Dim instance As MessageQueueAccessControlEntry

C#

public class MessageQueueAccessControlEntry
 : AccessControlEntry

C++

public ref class MessageQueueAccessControlEntry
 : public AccessControlEntry

J#

public class MessageQueueAccessControlEntry
 extends AccessControlEntry

JScript

public class MessageQueueAccessControlEntry
 extends AccessControlEntry

解説

MessageQueueAccessControlEntry クラスを使用して、トラスティに適用する権利を指定します。これらの権利には、メッセージのピーク、受信、または送信、キュー プロパティまたはアクセス許可の表示または変更、およびキューの削除が含まれます。MessageQueue クラスの SetPermissions メソッドは、このクラスのインスタンスをメソッドに直接渡すためのオーバーロード、または AccessControlList インスタンスに追加するためのオーバーロードを提供するため、複数のトラスティに同時に権利を追加できます。新しいアクセス権は、キューの随意アクセス制御リスト (DACL: discretionary access control list) の末尾に追加されます。DACL は、キューにアクセスできるユーザーおよびグループを識別します。

以上は、新しい権利が追加される位置とその効果についての一般的な説明ですが、一部の例外が存在します。詳細については、「System.Messaging」を参照してください。

MessageQueueAccessControlEntry コンストラクタのオーバーロードによって、AccessControlEntryType メンバを指定してトラスティへの権利を承認するか拒否するかを指定できます。リソースの DACL で権利が承認または拒否される順序は、指定した権利をトラスティが持つかどうかに影響します。たとえば、権利がトラスティに既に与えられている場合に、その権利を拒否するエントリを後で追加すると、システムが最初に検索するのは与えられた権利ですから、拒否されるようにするつもりだった権利がユーザーに与えられることになります。Set と Revoke の 2 つの種類のエントリを使用して、この動作をオーバーライドできます。アクセス権を決定する方法の制御の詳細については AccessControlEntryType 列挙型のトピックを参照してください。

MessageQueueAccessControlEntry クラスはアクセス制御リスト (ACL) に基づいてセキュリティと関連付けられており、このクラスを使用してユーザーにメッセージ キュー システム自体へのアクセスを与えることができます。これは MessageQueuePermission クラスおよび関連するクラスを通じて実装される、コード アクセス セキュリティとは異なります。メッセージ キューのコード アクセス セキュリティは、セキュリティ制御の対象である、アプリケーションが必要とするキュー固有の操作またはキュー アクセスを定義します。このコード アクセス セキュリティは、アプリケーションがこれらの操作を実行したり、またはアプリケーション内およびアプリケーション自体のアクセスを受け取ったりする権利を表してはいません。コード アクセス セキュリティの詳細については、「コード アクセス セキュリティ」を参照してください。

トラスティのメッセージ キュー アクセス許可を設定するには、Trustee クラスの新しいインスタンスを作成し、MessageQueueAccessControlEntry コンストラクタのオーバーロードに渡します。MessageQueueAccessRights のインスタンスをコンストラクタに渡すことによって、または既存の MessageQueueAccessControlEntry インスタンスの MessageQueueAccessRights プロパティを設定することによって、メッセージ キュー アクセス権を指定します。

次に、SetPermissions を呼び出す前に、MessageQueueAccessControlEntry インスタンスを MessageQueue.SetPermissions メソッドに直接渡すか、AccessControlList のインスタンスにエントリを追加します。

継承階層

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

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
MessageQueueAccessControlEntry メンバ
System.Messaging 名前空間
MessageQueue.SetPermissions
Trustee
AccessControlList クラス
AccessControlEntryType 列挙体
MessageQueuePermission