RegistrySecurity.AuditRuleFactory Metoda

Definice

Obor názvů:

System.Security.AccessControl

Sestavení:

Microsoft.Win32.Registry.dll

Vytvoří nové pravidlo auditu, které určuje uživatel, na který 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

Určuje IdentityReference uživatele nebo skupinu, na které se pravidlo vztahuje.

accessMask

Int32

Bitová RegistryRights kombinace hodnot určujících přístupová práva pro audit, 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 zděděno podklíči.

propagationFlags

PropagationFlags

Bitové kombinace PropagationFlags hodnot, které upravují způsob, jakým je pravidlo zděděno podklíči. Bez významu, pokud je inheritanceFlagshodnota None .

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ý typ metody je základní třída, AuditRuleale návratovou hodnotu lze bezpečně přetypovat na odvozenou třídu.

Výjimky

ArgumentOutOfRangeException

accessMask, inheritanceFlags, propagationFlagsnebo flags určuje neplatnou hodnotu.

ArgumentNullException

identityReference je null.

nebo

accessMask je nula.

ArgumentException

identityReference není typu SecurityIdentifier, ani typu, jako NTAccount je například lze převést na typ SecurityIdentifier.

Poznámky

Doporučeným způsobem vytvoření pravidel auditu je použití konstruktorů RegistryAuditRule třídy.

Note

I když můžete příznak zadat InheritanceFlags.ObjectInherit , není v tom žádný smysl. Pro účely řízení auditu nejsou dvojice název/hodnota v podklíči samostatné objekty. Práva auditu na páry název/hodnota jsou řízena právy podklíče. Vzhledem k tomu, že všechny podklíče jsou kontejnery (to znamená, že mohou obsahovat další podklíče), nejsou příznakem ObjectInherit ovlivněny. Nakonec zadání příznaku ObjectInherit zbytečně komplikuje údržbu pravidel, protože koliduje s normální kombinací kompatibilních pravidel.