SemaphoreSecurity.RemoveAuditRule(SemaphoreAuditRule) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Осуществляет поиск правила управления аудитом с тем же именем пользователя, что и указанного правила доступа, а также с совместимыми флагами наследования и распространения; если совместимое правило найдено, содержащиеся в указанном правиле права удаляются.
public:
bool RemoveAuditRule(System::Security::AccessControl::SemaphoreAuditRule ^ rule);
public bool RemoveAuditRule (System.Security.AccessControl.SemaphoreAuditRule rule);
override this.RemoveAuditRule : System.Security.AccessControl.SemaphoreAuditRule -> bool
Public Function RemoveAuditRule (rule As SemaphoreAuditRule) As Boolean
Параметры
- rule
- SemaphoreAuditRule
Объект SemaphoreAuditRule, определяющий пользователя для поиска, а также набор флагов наследования и распространения, с которыми должно быть совместимо найденное правило. Задает права, которые требуется удалить из совместимого правила, если оно будет найдено.
Возвращаемое значение
Значение true
, если совместимое правило найдено; в противном случае — значение false
.
Исключения
rule
имеет значение null
.
Комментарии
В текущем SemaphoreSecurity выполняется поиск правила аудита с тем же пользователем, что и rule
. Если такое правило не найдено, никаких действий не выполняется, и метод возвращает false
. Если правила сопоставления найдены, их флагов наследования и совместимости проверка на совместимость с флагов, указанных в rule
. Если не совместимое правило найдено, никакие действия не выполняются, и метод возвращает false
. Если обнаруживается правило с совместимыми флагами, права, указанные в rule
удаляются из совместимого правила, а метод возвращает true
. Если rule
задает права, не содержится в совместимого правила, никакие действия не выполняются по отношению к эти права. Если все права удаляются из совместимого правила, правило целиком удаляется из текущей SemaphoreSecurity объекта.
Важно!
Хотя вы можете указать флаги наследования и распространения для правил аудита семафора, создав их с AuditRuleFactory помощью метода , это не рекомендуется. Наследование и распространение не имеют смысла для именованных семафоров и усложняют обслуживание правил аудита.