RegistrySecurity.AuditRuleFactory メソッド

定義

名前空間:

System.Security.AccessControl

アセンブリ:

Microsoft.Win32.Registry.dll

規則の適用対象となるユーザー、監査するアクセス権、規則の継承と反映、および規則を発生させる結果を指定して、新しい監査規則を作成します。

public:
 override System::Security::AccessControl::AuditRule ^ AuditRuleFactory(System::Security::Principal::IdentityReference ^ identityReference, int accessMask, bool isInherited, System::Security::AccessControl::InheritanceFlags inheritanceFlags, System::Security::AccessControl::PropagationFlags propagationFlags, System::Security::AccessControl::AuditFlags flags);

public override System.Security.AccessControl.AuditRule AuditRuleFactory (System.Security.Principal.IdentityReference identityReference, int accessMask, bool isInherited, System.Security.AccessControl.InheritanceFlags inheritanceFlags, System.Security.AccessControl.PropagationFlags propagationFlags, System.Security.AccessControl.AuditFlags flags);

override this.AuditRuleFactory : System.Security.Principal.IdentityReference * int * bool * System.Security.AccessControl.InheritanceFlags * System.Security.AccessControl.PropagationFlags * System.Security.AccessControl.AuditFlags -> System.Security.AccessControl.AuditRule

Public Overrides Function AuditRuleFactory (identityReference As IdentityReference, accessMask As Integer, isInherited As Boolean, inheritanceFlags As InheritanceFlags, propagationFlags As PropagationFlags, flags As AuditFlags) As AuditRule

パラメーター

identityReference

IdentityReference

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

accessMask

Int32

監査するアクセス権を指定し、整数にキャストされる RegistryRights 値のビットごとの組み合わせ。

isInherited

Boolean

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

inheritanceFlags

InheritanceFlags

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

propagationFlags

PropagationFlags

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

flags

AuditFlags

成功したアクセス、失敗したアクセス、またはその両方のいずれを監査するかを示す AuditFlags 値のビットごとの組み合わせ。

戻り値

AuditRule

指定したユーザーに対する、指定した監査規則と指定したフラグを表す RegistryAuditRule オブジェクト。 メソッドの戻り値は基本クラス AuditRule です。ただし、この戻り値を派生クラスに安全にキャストできます。

例外

ArgumentOutOfRangeException

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

ArgumentNullException

identityReference が nullです。

- または -

accessMask が 0 です。

ArgumentException

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

注釈

監査規則を作成する推奨される方法は、 クラスのコンストラクターを RegistryAuditRule 使用することです。

注意

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