RegistrySecurity.AuditRuleFactory Метод

Определение

Пространство имен:

System.Security.AccessControl

Сборка:

Microsoft.Win32.Registry.dll

Создает новое правило аудита, указывающее пользователя, к которому применяется правило, права доступа к аудиту, наследование и распространение правила, а также результат, который активирует правило.

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

Параметры

identityReference

IdentityReference

Объект IdentityReference , определяющий пользователя или группу, к которому применяется правило.

accessMask

Int32

Побитовое сочетание значений RegistryRights , указывающее права доступа для аудита, приведение к целочислению.

isInherited

Boolean

Логическое значение, указывающее, наследуется ли правило.

inheritanceFlags

InheritanceFlags

Побитовое сочетание значений InheritanceFlags , указывающее, как правило наследуется вложенными ключами.

propagationFlags

PropagationFlags

Побитовое сочетание значений PropagationFlags , изменяющих способ наследования правила вложенными ключами. Бессмысленно, если значение inheritanceFlags равно None.

flags

AuditFlags

Побитовое сочетание значений, указывающее, следует ли проверять успешный AuditFlags доступ, неудачный доступ или оба.

Возвращаемое значение

AuditRule

RegistryAuditRule Объект, представляющий указанное правило аудита для указанного пользователя с указанными флагами. Возвращаемый тип метода является базовым классом, AuditRuleно возвращаемое значение можно безопасно привести к производного класса.

Исключения

ArgumentOutOfRangeException

accessMask, , inheritanceFlagspropagationFlagsили flags указывает недопустимое значение.

ArgumentNullException

identityReference равно null.

–или–

accessMask равно нулю.

ArgumentException

identityReference не является типом, ни типом SecurityIdentifier, например NTAccount , который можно преобразовать в тип SecurityIdentifier.

Комментарии

Рекомендуемый способ создания правил аудита — использовать конструкторы RegistryAuditRule класса.

Note

Хотя флаг можно указать InheritanceFlags.ObjectInherit , нет смысла делать это. В целях управления аудитом пары name/value в подразделе не являются отдельными объектами. Права аудита для пар name/value управляются правами подраздела. Кроме того, так как все вложенные ключи являются контейнерами (т. е. они могут содержать другие подразделы), они не влияют на ObjectInherit флаг. Наконец, указание флага без необходимости усложняет ObjectInherit обслуживание правил, так как это мешает нормальному сочетанию совместимых правил.