MutexSecurity.AccessRuleFactory メソッド

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

MutexSecurity.AccessRuleFactory メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

アクセス権、アクセス制御、およびフラグを指定して、指定したユーザーに対して新しいアクセス制御規則を作成します。

名前空間: System.Security.AccessControl
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Overrides Function
 AccessRuleFactory ( _
    identityReference As IdentityReference, _
    accessMask As Integer, _
    isInherited As Boolean, _
    inheritanceFlags As InheritanceFlags, _
    propagationFlags As PropagationFlags, _
    type As AccessControlType _
) As AccessRule

Visual Basic (使用法)

Dim instance As MutexSecurity
Dim identityReference As IdentityReference
Dim accessMask As Integer
Dim isInherited As Boolean
Dim inheritanceFlags As InheritanceFlags
Dim propagationFlags As PropagationFlags
Dim type As AccessControlType
Dim returnValue As AccessRule

returnValue = instance.AccessRuleFactory(identityReference, accessMask, isInherited,
 inheritanceFlags, propagationFlags, type)

C#

public override AccessRule AccessRuleFactory (
    IdentityReference identityReference,
    int accessMask,
    bool isInherited,
    InheritanceFlags inheritanceFlags,
    PropagationFlags propagationFlags,
    AccessControlType type
)

C++

public:
virtual AccessRule^ AccessRuleFactory (
    IdentityReference^ identityReference, 
    int accessMask, 
    bool isInherited, 
    InheritanceFlags inheritanceFlags, 
    PropagationFlags propagationFlags, 
    AccessControlType type
) override

J#

public AccessRule AccessRuleFactory (
    IdentityReference identityReference, 
    int accessMask, 
    boolean isInherited, 
    InheritanceFlags inheritanceFlags, 
    PropagationFlags propagationFlags, 
    AccessControlType type
)

JScript

public override function AccessRuleFactory
 (
    identityReference : IdentityReference, 
    accessMask : int, 
    isInherited : boolean, 
    inheritanceFlags : InheritanceFlags, 
    propagationFlags : PropagationFlags, 
    type : AccessControlType
) : AccessRule

パラメータ

identityReference

規則の適用対象となるユーザーまたはグループを識別する IdentityReference。

accessMask

許可または拒否するアクセス権を指定し、整数にキャストされる MutexRights 値のビットごとの組み合わせ。

isInherited

名前付きミューテックスには階層構造がないため何の効果もありません。

inheritanceFlags

名前付きミューテックスには階層構造がないため何の効果もありません。

propagationFlags

名前付きミューテックスには階層構造がないため何の効果もありません。

type

アクセス権が許可されているかどうかを指定する AccessControlType 値の 1 つ。

戻り値
指定したユーザーの指定した権限を表す MutexAccessRule オブジェクト。

例外

例外の種類	条件
ArgumentOutOfRangeException	accessMask、inheritanceFlags、propagationFlags、または type に無効な値が指定されています。
ArgumentNullException	identityReference が null 参照 (Visual Basic では Nothing) です。 または accessMask が 0 です。
ArgumentException	identityReference が SecurityIdentifier 型ではなく、SecurityIdentifier 型に変換できる NTAccount などの型でもありません。

解説

アクセス制御規則を作成するには、MutexAccessRule クラスのコンストラクタの使用をお勧めします。

メモ
継承フラグと反映フラグは、名前付きミューテックスに対しては無効ですが、指定はできます。ただし、その場合、本来は互換性のある規則の組み合わせからの干渉などによって規則の保守が必要以上に複雑になるので、このような指定はお勧めできません。

プラットフォーム

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

参照

関連項目
MutexSecurity クラス
MutexSecurity メンバ
System.Security.AccessControl 名前空間