RegistrySecurity.AuditRuleFactory Metoda
Definicja
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
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
accessMask, inheritanceFlags, propagationFlagslub flags określa nieprawidłową wartość.
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.