RegistryAuditRule

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

RegistryAuditRule クラス

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

ユーザーまたはグループについて監査するアクセス権セットを表します。このクラスは継承できません。

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

Visual Basic (宣言)

Public NotInheritable Class
 RegistryAuditRule
    Inherits AuditRule

Visual Basic (使用法)

Dim instance As RegistryAuditRule

C#

public sealed class RegistryAuditRule : AuditRule

C++

public ref class RegistryAuditRule sealed :
 public AuditRule

J#

public final class RegistryAuditRule extends
 AuditRule

JScript

public final class RegistryAuditRule extends
 AuditRule

解説

RegistryAuditRule クラスは、レジストリ キーに関する Windows のアクセス制御セキュリティを管理するために .NET Framework で提供されるクラスのセットに含まれています。これらのクラスの概要、および基になる Windows のアクセス制御構造との関係については、RegistrySecurity に関するトピックを参照してください。

メモ
Windows のアクセス制御セキュリティは、レジストリ キーだけに適用できます。キーに格納されている個別のキーと値ペアに適用することはできません。

レジストリ キーに現在適用されている監査規則の一覧を取得するには、RegistryKey.GetAccessControl メソッドを使用して RegistrySecurity オブジェクトを取得し、その GetAuditRules メソッドを使用して RegistryAuditRule オブジェクトのコレクションを取得します。

RegistryAuditRule オブジェクトは、基になる随意アクセス制御リスト (DACL: Discretionary Access Control List) のアクセス制御エントリと一対一には対応していません。レジストリ キーに関するすべての監査規則のセットを取得する場合、このセットには、すべてのアクセス制御エントリを表すために現在必要な最低限の数の規則だけが含まれます。

メモ
規則を適用したり削除したりすると、基になるアクセス制御エントリが変化します。規則の情報は、アクセス制御エントリの数を最小限に維持するため、可能な限りマージされます。したがって、現在の規則一覧を読み込んだ場合、追加したすべての規則の一覧とまったく同じ体裁になるとは限りません。

RegistryAuditRule オブジェクトを使用して、ユーザーまたはグループについて監査するアクセス権を指定します。レジストリ キーに規則を適用するには、RegistryKey.GetAccessControl メソッドを使用して RegistrySecurity オブジェクトを取得します。規則を追加するメソッドを使用して RegistrySecurity オブジェクトを変更し、RegistryKey.SetAccessControl メソッドを使用してセキュリティ オブジェクトを再度割り当てます。

重要 :
RegistrySecurity オブジェクトに加えた変更は、RegistryKey.SetAccessControl メソッドを呼び出して、変更したセキュリティ オブジェクトをレジストリ キーに割り当てるまで、レジストリ キーのアクセス レベルに影響しません。

RegistryAuditRule オブジェクトは変更不可です。レジストリ キーのセキュリティは、規則を追加または削除する RegistrySecurity クラスのメソッドを使用して変更します。この操作によって、基になるアクセス制御エントリが変更されます。

継承階層

System.Object
   System.Security.AccessControl.AuthorizationRule
     System.Security.AccessControl.AuditRule
      System.Security.AccessControl.RegistryAuditRule

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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

参照

関連項目
RegistryAuditRule メンバ
System.Security.AccessControl 名前空間

RegistryAuditRule コンストラクタ (IdentityReference, RegistryRights, InheritanceFlags, PropagationFlags, AuditFlags)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

監査するユーザーまたはグループ、監査する権限、継承を考慮するかどうか、成功、失敗、またはその両方のいずれを監査するかを指定して、RegistryAuditRule クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    identity As IdentityReference, _
    registryRights As RegistryRights, _
    inheritanceFlags As InheritanceFlags, _
    propagationFlags As PropagationFlags, _
    flags As AuditFlags _
)

Visual Basic (使用法)

Dim identity As IdentityReference
Dim registryRights As RegistryRights
Dim inheritanceFlags As InheritanceFlags
Dim propagationFlags As PropagationFlags
Dim flags As AuditFlags

Dim instance As New RegistryAuditRule(identity,
 registryRights, inheritanceFlags, propagationFlags, flags)

C#

public RegistryAuditRule (
    IdentityReference identity,
    RegistryRights registryRights,
    InheritanceFlags inheritanceFlags,
    PropagationFlags propagationFlags,
    AuditFlags flags
)

C++

public:
RegistryAuditRule (
    IdentityReference^ identity, 
    RegistryRights registryRights, 
    InheritanceFlags inheritanceFlags, 
    PropagationFlags propagationFlags, 
    AuditFlags flags
)

J#

public RegistryAuditRule (
    IdentityReference identity, 
    RegistryRights registryRights, 
    InheritanceFlags inheritanceFlags, 
    PropagationFlags propagationFlags, 
    AuditFlags flags
)

JScript

public function RegistryAuditRule (
    identity : IdentityReference, 
    registryRights : RegistryRights, 
    inheritanceFlags : InheritanceFlags, 
    propagationFlags : PropagationFlags, 
    flags : AuditFlags
)

パラメータ

identity

規則の適用対象となるユーザーまたはグループ。SecurityIdentifier 型にするか、または SecurityIdentifier 型に変換できる NTAccount などの型にする必要があります。

registryRights

監査するアクセスの種類を指定する RegistryRights 値のビットごとの組み合わせ。

inheritanceFlags

監査規則を現在のキーのサブキーに適用するかどうかを指定する InheritanceFlags 値のビットごとの組み合わせ。

propagationFlags

継承された監査規則を現在のキーのサブ キーに反映させる方法に影響する PropagationFlags 値のビットごとの組み合わせ。

flags

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

例外

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

解説

すべてのレジストリ キーはコンテナなので、レジストリ キーにとって意味がある継承フラグは、InheritanceFlags.ContainerInherit フラグだけです。このフラグを指定しないと、反映フラグは無視され、直接のキーだけが影響を受けます。このフラグが存在する場合、次の表に示すように、規則が反映されます。この表では、サブキー S が存在し、このサブキー S に子サブキー CS と孫サブキー GS が含まれていることを前提にしています。そのため、孫サブキーへのパスは、S\CS\GS になります。

反映フラグ	S	CS	GS
None	X	X	X
NoPropagateInherit	X	X
InheritOnly		X	X
NoPropagateInherit, InheritOnly		X

孫サブキーのパターンは、孫サブキーによって格納されるすべてのサブキーに適用されます。

たとえば、inheritanceFlags に対して ContainerInherit フラグを指定し、propagationFlags に対して InheritOnly 反映フラグを指定すると、この規則は、直接のサブキーには適用されず、すべての直接の子サブキーと子サブキーに格納されるすべてのサブキーに適用されます。

メモ
inheritanceFlags に 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

参照

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

RegistryAuditRule コンストラクタ (String, RegistryRights, InheritanceFlags, PropagationFlags, AuditFlags)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

監査するユーザーまたはグループの名前、監査する権限、継承を考慮するかどうか、成功、失敗、またはその両方のいずれを監査するかを指定して、RegistryAuditRule クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    identity As String, _
    registryRights As RegistryRights, _
    inheritanceFlags As InheritanceFlags, _
    propagationFlags As PropagationFlags, _
    flags As AuditFlags _
)

Visual Basic (使用法)

Dim identity As String
Dim registryRights As RegistryRights
Dim inheritanceFlags As InheritanceFlags
Dim propagationFlags As PropagationFlags
Dim flags As AuditFlags

Dim instance As New RegistryAuditRule(identity,
 registryRights, inheritanceFlags, propagationFlags, flags)

C#

public RegistryAuditRule (
    string identity,
    RegistryRights registryRights,
    InheritanceFlags inheritanceFlags,
    PropagationFlags propagationFlags,
    AuditFlags flags
)

C++

public:
RegistryAuditRule (
    String^ identity, 
    RegistryRights registryRights, 
    InheritanceFlags inheritanceFlags, 
    PropagationFlags propagationFlags, 
    AuditFlags flags
)

J#

public RegistryAuditRule (
    String identity, 
    RegistryRights registryRights, 
    InheritanceFlags inheritanceFlags, 
    PropagationFlags propagationFlags, 
    AuditFlags flags
)

JScript

public function RegistryAuditRule (
    identity : String, 
    registryRights : RegistryRights, 
    inheritanceFlags : InheritanceFlags, 
    propagationFlags : PropagationFlags, 
    flags : AuditFlags
)

パラメータ

identity

規則の適用対象となるユーザー名またはグループ名。

registryRights

監査するアクセスの種類を指定する RegistryRights 値のビットごとの組み合わせ。

inheritanceFlags

監査規則を現在のキーのサブキーに適用するかどうかを指定する InheritanceFlags フラグの組み合わせ。

propagationFlags

継承された監査規則を現在のキーのサブ キーに反映させる方法に影響する PropagationFlags フラグの組み合わせ。

flags

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

例外

例外の種類	条件
ArgumentOutOfRangeException	eventRights に無効な値が指定されています。 または flags に無効な値が指定されています。 または inheritanceFlags に無効な値が指定されています。 または propagationFlags に無効な値が指定されています。
ArgumentNullException	registryRights が 0 です。
ArgumentException	identity が null 参照 (Visual Basic では Nothing) です。 または identity は、長さ 0 の文字列です。 または identity が 512 文字を超えています。

解説

すべてのレジストリ キーはコンテナなので、レジストリ キーにとって意味がある継承フラグは、InheritanceFlags.ContainerInherit フラグだけです。このフラグを指定しないと、反映フラグは無視され、直接のキーだけが影響を受けます。このフラグが存在する場合、次の表に示すように、規則が反映されます。この表では、サブキー S が存在し、このサブキー S に子サブキー CS と孫サブキー GS が含まれていることを前提にしています。そのため、孫サブキーへのパスは、S\CS\GS になります。

反映フラグ	S	CS	GS
None	X	X	X
NoPropagateInherit	X	X
InheritOnly		X	X
NoPropagateInherit, InheritOnly		X

孫サブキーのパターンは、孫サブキーによって格納されるすべてのサブキーに適用されます。

たとえば、inheritanceFlags に対して ContainerInherit フラグを指定し、propagationFlags に対して InheritOnly 反映フラグを指定すると、この規則は、直接のサブキーには適用されず、すべての直接の子サブキーと子サブキーに格納されるすべてのサブキーに適用されます。

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

このコンストラクタは、identity を System.Security.Principal.NTAccount(String) コンストラクタに渡し、新しく作成した NTAccount オブジェクトを RegistryAuditRule(IdentityReference,RegistryRights,InheritanceFlags,PropagationFlags,AuditFlags) コンストラクタに渡して、NTAccount オブジェクトを作成するのと同じ働きをします。

プラットフォーム

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

参照

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

RegistryAuditRule コンストラクタ

RegistryAuditRule クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
RegistryAuditRule (IdentityReference, RegistryRights, InheritanceFlags, PropagationFlags, AuditFlags)	監査するユーザーまたはグループ、監査する権限、継承を考慮するかどうか、成功、失敗、またはその両方のいずれを監査するかを指定して、RegistryAuditRule クラスの新しいインスタンスを初期化します。
RegistryAuditRule (String, RegistryRights, InheritanceFlags, PropagationFlags, AuditFlags)	監査するユーザーまたはグループの名前、監査する権限、継承を考慮するかどうか、成功、失敗、またはその両方のいずれを監査するかを指定して、RegistryAuditRule クラスの新しいインスタンスを初期化します。

参照

関連項目

RegistryAuditRule クラス
RegistryAuditRule メンバ
System.Security.AccessControl 名前空間

RegistryAuditRule プロパティ

パブリック プロパティ

	名前	説明
	AuditFlags	この監査規則の監査フラグを取得します。 ( AuditRule から継承されます。)
	IdentityReference	この規則を適用する IdentityReference を取得します。 ( AuthorizationRule から継承されます。)
	InheritanceFlags	この規則を子オブジェクトが継承する方法を決定するフラグの値を取得します。 ( AuthorizationRule から継承されます。)
	IsInherited	この規則を明示的に設定するか、または親コンテナ オブジェクトから継承するかを指定する値を取得します。 ( AuthorizationRule から継承されます。)
	PropagationFlags	反映フラグの値を取得します。このフラグから、この規則を子オブジェクトに反映させる方法を判断します。このプロパティが重要なのは、InheritanceFlags 列挙体の値が None でない場合だけです。 ( AuthorizationRule から継承されます。)
	RegistryRights	監査規則の影響を受けるアクセス権を取得します。

参照

関連項目

RegistryAuditRule クラス
System.Security.AccessControl 名前空間

RegistryAuditRule メソッド

パブリック メソッド

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

参照

関連項目

RegistryAuditRule クラス
System.Security.AccessControl 名前空間

RegistryAuditRule メンバ

ユーザーまたはグループについて監査するアクセス権セットを表します。このクラスは継承できません。

RegistryAuditRule データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	RegistryAuditRule	オーバーロードされます。 RegistryAuditRule クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	AuditFlags	この監査規則の監査フラグを取得します。(AuditRule から継承されます。)
	IdentityReference	この規則を適用する IdentityReference を取得します。(AuthorizationRule から継承されます。)
	InheritanceFlags	この規則を子オブジェクトが継承する方法を決定するフラグの値を取得します。(AuthorizationRule から継承されます。)
	IsInherited	この規則を明示的に設定するか、または親コンテナ オブジェクトから継承するかを指定する値を取得します。(AuthorizationRule から継承されます。)
	PropagationFlags	反映フラグの値を取得します。このフラグから、この規則を子オブジェクトに反映させる方法を判断します。このプロパティが重要なのは、InheritanceFlags 列挙体の値が None でない場合だけです。(AuthorizationRule から継承されます。)
	RegistryRights	監査規則の影響を受けるアクセス権を取得します。

パブリック メソッド

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

参照

関連項目

RegistryAuditRule クラス
System.Security.AccessControl 名前空間