RegistrySecurity.AuditRuleFactory Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Security.AccessControl

Zestaw:: Microsoft.Win32.Registry.dll

Zestaw:: Microsoft.Win32.Registry.AccessControl.dll

Zestaw:: mscorlib.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Tworzy nową regułę inspekcji, określając użytkownika, do której ma zastosowanie reguła, prawa dostępu do inspekcji, dziedziczenie i propagację reguły oraz wynik wyzwalający regułę.

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

Parametry

identityReference: IdentityReference

Element IdentityReference identyfikujący użytkownika lub grupę, do którego ma zastosowanie reguła.

accessMask: Int32

Bitowa kombinacja wartości określających RegistryRights prawa dostępu do inspekcji, rzutowane na liczbę całkowitą.

isInherited: Boolean

Wartość logiczna określająca, czy reguła jest dziedziczona.

inheritanceFlags: InheritanceFlags

Bitowa kombinacja wartości określających InheritanceFlags , w jaki sposób reguła jest dziedziczona przez podklucze.

propagationFlags: PropagationFlags

Bitowa kombinacja PropagationFlags wartości, które modyfikują sposób dziedziczenia reguły przez podklucze. Bez znaczenia, jeśli wartość to inheritanceFlags None.

flags: AuditFlags

Bitowa kombinacja wartości określających, czy przeprowadzić inspekcję pomyślnego AuditFlags dostępu, dostępu zakończonego niepowodzeniem, czy obu tych opcji.

Zwraca

AuditRule

RegistryAuditRule Obiekt reprezentujący określoną regułę inspekcji dla określonego użytkownika z określonymi flagami. Zwracany typ metody to klasa bazowa, AuditRuleale wartość zwracana może być bezpiecznie rzutować do klasy pochodnej.

Wyjątki

ArgumentOutOfRangeException

accessMask, inheritanceFlags, propagationFlagslub flags określa nieprawidłową wartość.

ArgumentNullException

identityReference to null.

-lub- accessMask jest zero.

ArgumentException

identityReference nie ma typu SecurityIdentifier, ani typu, takiego jak NTAccount typ , który można przekonwertować na typ SecurityIdentifier.

Uwagi

Zalecanym sposobem tworzenia reguł inspekcji jest użycie konstruktorów RegistryAuditRule klasy.

Uwaga

Chociaż można określić flagę InheritanceFlags.ObjectInherit , nie ma sensu tego robić. Na potrzeby kontroli inspekcji pary nazw/wartości w podkluczu nie są oddzielnymi obiektami. Prawa inspekcji do par nazw/wartości są kontrolowane przez prawa podklucza. Ponadto, ponieważ wszystkie podklucze są kontenerami (czyli mogą zawierać inne podklucze), nie mają one wpływu na flagę ObjectInherit . Na koniec określenie flagi ObjectInherit niepotrzebnie komplikuje konserwację reguł, ponieważ zakłóca normalne połączenie reguł zgodnych.

Dotyczy