RegistrySecurity.AuditRuleFactory Metod

Definition

Skapar en ny granskningsregel som anger vilken användare regeln gäller för, åtkomsträttigheterna till granskning, arv och spridning av regeln samt resultatet som utlöser regeln.

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

Parametrar

identityReference
IdentityReference

En IdentityReference som identifierar den användare eller grupp som regeln gäller för.

accessMask
Int32

En bitvis kombination av RegistryRights värden som anger åtkomsträttigheterna för granskning, som skickas till ett heltal.

isInherited
Boolean

Ett booleskt värde som anger om regeln ärvs.

inheritanceFlags
InheritanceFlags

En bitvis kombination av InheritanceFlags värden som anger hur regeln ärvs av undernycklar.

propagationFlags
PropagationFlags

En bitvis kombination av PropagationFlags värden som ändrar hur regeln ärvs av undernycklar. Meningslöst om värdet inheritanceFlags för är None.

flags
AuditFlags

En bitvis kombination av AuditFlags värden som anger om du vill granska lyckad åtkomst, misslyckad åtkomst eller båda.

Returer

Ett RegistryAuditRule objekt som representerar den angivna granskningsregeln för den angivna användaren med angivna flaggor. Returtypen för metoden är basklassen, AuditRule, men returvärdet kan skickas säkert till den härledda klassen.

Undantag

accessMask, inheritanceFlags, propagationFlags, eller flags anger ett ogiltigt värde.

identityReference är null.

-eller-

accessMask är noll.

identityReference är varken av typen SecurityIdentifier, eller av en typ som NTAccount kan konverteras till typen SecurityIdentifier.

Kommentarer

Det rekommenderade sättet att skapa granskningsregler är att använda klassens RegistryAuditRule konstruktorer.

Note

Även om du kan ange InheritanceFlags.ObjectInherit flaggan är det ingen idé att göra det. För granskningskontroll är namn/värde-paren i en undernyckel inte separata objekt. Granskningsrättigheterna till namn/värde-par styrs av undernyckelns rättigheter. Eftersom alla undernycklar är containrar (dvs. de kan innehålla andra undernycklar) påverkas de inte av ObjectInherit flaggan. Slutligen komplicerar ObjectInherit att ange flaggan i onödan underhållet av regler, eftersom det stör den normala kombinationen av kompatibla regler.

Gäller för