RegistrySecurity.AccessRuleFactory メソッド

定義

名前空間:

System.Security.AccessControl

アセンブリ:

Microsoft.Win32.Registry.dll

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

public:
 override System::Security::AccessControl::AccessRule ^ AccessRuleFactory(System::Security::Principal::IdentityReference ^ identityReference, int accessMask, bool isInherited, System::Security::AccessControl::InheritanceFlags inheritanceFlags, System::Security::AccessControl::PropagationFlags propagationFlags, System::Security::AccessControl::AccessControlType type);

public override System.Security.AccessControl.AccessRule AccessRuleFactory (System.Security.Principal.IdentityReference identityReference, int accessMask, bool isInherited, System.Security.AccessControl.InheritanceFlags inheritanceFlags, System.Security.AccessControl.PropagationFlags propagationFlags, System.Security.AccessControl.AccessControlType type);

override this.AccessRuleFactory : System.Security.Principal.IdentityReference * int * bool * System.Security.AccessControl.InheritanceFlags * System.Security.AccessControl.PropagationFlags * System.Security.AccessControl.AccessControlType -> System.Security.AccessControl.AccessRule

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

パラメーター

identityReference

IdentityReference

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

accessMask

Int32

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

isInherited

Boolean

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

inheritanceFlags

InheritanceFlags

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

propagationFlags

PropagationFlags

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

type

AccessControlType

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

戻り値

AccessRule

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

例外

ArgumentOutOfRangeException

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

ArgumentNullException

identityReference が nullです。

- または -

accessMask が 0 です。

ArgumentException

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

注釈

アクセス制御規則を作成する推奨される方法は、 クラスのコンストラクターを RegistryAccessRule 使用することです。

注意

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