MessageQueue.SetPermissions メソッド (AccessControlList)

[アーティクル]
03/28/2008

アクセス制御リストの内容に基づいてアクセス権をキューに割り当てます。

Overloads Public Sub SetPermissions( _
   ByVal dacl As AccessControlList _)
[C#]
public void SetPermissions(AccessControlListdacl);
[C++]
public: void SetPermissions(AccessControlList* dacl);
[JScript]
public function SetPermissions(
   dacl : AccessControlList);

パラメータ

dacl
トラスティと与えるアクセス許可を指定する 1 つ以上のアクセス制御エントリを含む AccessControlList 。

例外

例外の種類	条件
MessageQueueException	メッセージキューの API にアクセスしたときにエラーが発生しました。

解説

このオーバーロードを使用して、アクセス権の付与、拒否、または取り消しを行います。これは、アクセス制御エントリのコレクションを使用して、トラスティとアクセス権の情報を指定することで行います。これを使用して、たとえば、同時に複数のユーザーにアクセス許可を与えます。

ace パラメータを構築するときに、トラスティとしてユーザー、ユーザーグループ、またはコンピュータをそれぞれ指定できます。トラスティが個別のユーザーの場合、書式 DOMAIN\ user を使用します。トラスティがローカルコンピュータの場合は、"." と指定します。

SetPermissions で割り当てたアクセス許可は、既存のリストに権利を追加します。既定では、パブリックキューまたはプライベートキューの作成者にフルコントロールが付与され、ドメイングループ Everyone にキューのプロパティの取得、アクセス許可の取得、およびキューへの書き込み権限が付与されます。 SetPermissions を呼び出す場合は、ユーザーとアクセス許可の情報が既存リストの末尾に追加されます。

システムは、下記のイベントのいずれかが発生するまで各 AccessControlEntry を順番に調べます。

アクセス拒否 AccessControlEntry が、スレッドのアクセストークンにリストされているトラスティの 1 つについて要求されたアクセス権を明示的に拒否します。
スレッドのアクセストークンにリストされたトラスティの 1 つ以上のアクセス許可 AccessControlEntry 項目が、要求されたすべてのアクセス権を明示的に与えます。
すべての AccessControlEntry 項目を確認した結果、要求されたアクセス権の中に明示的に許可されていないアクセス権が少なくとも 1 つあった場合はアクセスが暗黙的に拒否されます。

dacl パラメータを構築するときに、 AccessControlEntry インスタンスを AccessControlList コレクションに追加します。各アクセス制御エントリを構築するときに、汎用 (標準) アクセス権を指定できます。キューに対するアクセス権は、次の任意の組み合わせにできます。

削除
セキュリティの読み取り
セキュリティの書き込み
同期化
所有者の変更
読み取り
書き込み
実行
必須
すべて
なし

これらのアクセス権はビットフラグのセットです。ビット処理演算子 OR を使用して組み合わせることができます。

フルコントロール
メッセージの削除
メッセージの受信
メッセージのピーク
ジャーナルメッセージの受信
キューのプロパティの取得
キューのプロパティの設定
アクセス許可の取得
アクセス許可の設定
キューの所有権の取得
メッセージの書き込み

このメソッドが各種のワークグループモードで使用できるかどうかを次の表に示します。

ワークグループモード	使用可否
ローカルコンピュータ	はい
ローカルコンピュータ + 直接書式名	はい
リモートコンピュータ	いいえ
リモートコンピュータ + 直接書式名	いいえ

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

直前の呼び出し元の完全信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細の参照先 : 部分信頼コードからのライブラリの使用

参照

次の方法で共有

MessageQueue.SetPermissions メソッド (AccessControlList)

パラメータ

例外

解説

必要条件

参照

その他のリソース