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
, propagationFlags
lub 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.