RegistrySecurity.AuditRuleFactory Metoda

Definice

Obor názvů:

System.Security.AccessControl

Sestavení:

Microsoft.Win32.Registry.dll

Vytvoří nové pravidlo auditu, které určí uživatele, na kterého se pravidlo vztahuje, přístupová práva k auditování, dědičnost a šíření pravidla a výsledek, který pravidlo aktivuje.

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

Identifikátor IdentityReference , který identifikuje uživatele nebo skupinu, na kterou se pravidlo vztahuje.

accessMask

Int32

Bitová kombinace RegistryRights hodnot, které určují přístupová práva k auditování, přetypování na celé číslo.

isInherited

Boolean

Logická hodnota určující, zda je pravidlo zděděno.

inheritanceFlags

InheritanceFlags

Bitové kombinace hodnot určující, InheritanceFlags jak je pravidlo děděno podklíči.

propagationFlags

PropagationFlags

Bitové kombinace PropagationFlags hodnot, které mění způsob dědění pravidla podklíči. Bezvýznamné, pokud je Nonehodnota parametru inheritanceFlags .

flags

AuditFlags

Bitové kombinace hodnot určující, AuditFlags jestli se má auditovat úspěšný přístup, neúspěšný přístup nebo obojí.

Návraty

AuditRule

Objekt RegistryAuditRule představující zadané pravidlo auditu pro zadaného uživatele se zadanými příznaky. Návratovým typem metody je základní třída , AuditRuleale návratovou hodnotu lze bezpečně přetypovat na odvozenou třídu.

Výjimky

ArgumentOutOfRangeException

accessMask, , inheritanceFlagspropagationFlagsnebo flags určuje neplatnou hodnotu.

ArgumentNullException

identityReference je null.

-nebo-

accessMask je nula.

ArgumentException

identityReference není typu SecurityIdentifier, ani takového typu NTAccount , který lze převést na typ SecurityIdentifier.

Poznámky

Doporučený způsob, jak vytvořit pravidla auditu, je použít konstruktory RegistryAuditRule třídy .

Poznámka

I když můžete zadat InheritanceFlags.ObjectInherit příznak, nemá to smysl. Pro účely řízení auditu nejsou dvojice název/hodnota v podklíči samostatné objekty. Práva auditu ke dvojicím název/hodnota se řídí právy podklíče. Vzhledem k tomu, že všechny podklíče jsou kontejnery (to znamená, že můžou obsahovat další podklíče), nejsou příznakem ovlivněny ObjectInherit . Nakonec zadání příznaku ObjectInherit zbytečně komplikuje údržbu pravidel, protože narušuje normální kombinaci kompatibilních pravidel.