RegistrySecurity.AccessRuleFactory メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

RegistrySecurity.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 RegistrySecurity
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)

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

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: 許可または拒否するアクセス権を示し、整数にキャストされる RegistryRights 値のビットごとの組み合わせ。

isInherited: 規則が継承されるかどうかを示すブール値。

inheritanceFlags: サブキーによって規則を継承する方法を示す InheritanceFlags 値のビットごとの組み合わせ。

propagationFlags: サブキーによって規則を継承する方法を変更する PropagationFlags 値のビットごとの組み合わせ。inheritanceFlags の値が InheritanceFlags.None の場合、無効です。

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

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

例外

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

例外の種類

条件

ArgumentOutOfRangeException

accessMask、inheritanceFlags、propagationFlags、または type に無効な値が指定されています。

ArgumentNullException

identityReference が null 参照 (Visual Basic では Nothing) です。

または

accessMask が 0 です。

ArgumentException

identityReference が SecurityIdentifier 型ではなく、SecurityIdentifier 型に変換できる NTAccount などの型でもありません。

解説

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

メモ
InheritanceFlags.ObjectInherit フラグを指定することもできますが、意味がありません。アクセス制御という目的上、サブキー内の名前/値ペアは別個のオブジェクトにはなっていません。名前/値ペアに対するアクセス権は、サブキーの権限によって制御されます。さらに、すべてのサブキーがコンテナであり、他のサブキーを含めることができるため、ObjectInherit フラグの影響を受けません。また、ObjectInherit フラグを指定すると、互換性のある規則の通常の組み合わせに干渉するため、規則の管理が必要以上に複雑になります。