RegistrySecurity.AccessRuleFactory メソッド

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

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

許可または拒否するアクセス権を示し、整数にキャストされる 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 などの型でもありません。

解説

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

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

プラットフォーム

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

参照

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