RegistrySecurity.AuditRuleFactory メソッド

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

RegistrySecurity.AuditRuleFactory メソッド

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

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

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

Visual Basic (宣言)

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

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 flags As AuditFlags
Dim returnValue As AuditRule

returnValue = instance.AuditRuleFactory(identityReference, accessMask, isInherited,
 inheritanceFlags, propagationFlags, flags)

C#

public override AuditRule AuditRuleFactory (
    IdentityReference identityReference,
    int accessMask,
    bool isInherited,
    InheritanceFlags inheritanceFlags,
    PropagationFlags propagationFlags,
    AuditFlags flags
)

C++

public:
virtual AuditRule^ AuditRuleFactory (
    IdentityReference^ identityReference, 
    int accessMask, 
    bool isInherited, 
    InheritanceFlags inheritanceFlags, 
    PropagationFlags propagationFlags, 
    AuditFlags flags
) override

J#

public AuditRule AuditRuleFactory (
    IdentityReference identityReference, 
    int accessMask, 
    boolean isInherited, 
    InheritanceFlags inheritanceFlags, 
    PropagationFlags propagationFlags, 
    AuditFlags flags
)

JScript

public override function AuditRuleFactory (
    identityReference : IdentityReference, 
    accessMask : int, 
    isInherited : boolean, 
    inheritanceFlags : InheritanceFlags, 
    propagationFlags : PropagationFlags, 
    flags : AuditFlags
) : AuditRule

パラメータ

identityReference

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

accessMask

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

isInherited

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

inheritanceFlags

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

propagationFlags

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

flags

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

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

例外

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

解説

監査規則を作成するには、RegistryAuditRule クラスのコンストラクタを使用することをお勧めします。

メモ
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 名前空間