RegistrySecurity.AuditRuleFactory Metoda

Definicja

Przestrzeń nazw:

System.Security.AccessControl

Zestaw:

Microsoft.Win32.Registry.dll

Tworzy nową regułę inspekcji, określając użytkownika, do którego 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 rzutowania na liczbę całkowitą.

isInherited

Boolean

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

inheritanceFlags

InheritanceFlags

Bitowa kombinacja InheritanceFlags wartości określających, jak 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 inheritanceFlagsNone.

flags

AuditFlags

Bitowa kombinacja wartości określających, czy inspekcja pomyślnego AuditFlags dostępu, nieudanego dostępu, 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 jest klasą bazową , AuditRuleale wartość zwracana może być bezpiecznie rzutować do klasy pochodnej.

Wyjątki

ArgumentOutOfRangeException

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

ArgumentNullException

Parametr identityReference ma wartość null.

— lub —

accessMask jest zero.

ArgumentException

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

Uwagi

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

Note

Chociaż można określić flagę InheritanceFlags.ObjectInherit , nie ma sensu w tym celu. Na potrzeby kontroli inspekcji pary nazw/wartości w podkluczu nie są oddzielnymi obiektami. Prawa inspekcji do par nazwa/wartość 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 normalną kombinację zgodnych reguł.