TestimoX

API Reference

Class

RegistryAclControl

Namespace ComputerX.Controls
Assembly ComputerX
Implements
Modifiers sealed

Evaluates registry key DACL against a set of required ACEs. Desired entries format: "Principal|Rights|Allow". Rights accept RegistryRights tokens (e.g., FullControl, ReadKey, WriteKey).

Inheritance

  • Object
  • RegistryAclControl

Constructors

public RegistryAclControl(String id, String title, String keyPath) #

Creates a registry ACL control for a specific key path.

Parameters

id System.String requiredposition: 0
title System.String requiredposition: 1
keyPath System.String requiredposition: 2

Methods

public virtual CxEval Evaluate(String host, CxFacts facts) #
Returns: CxEval

Evaluates current DACL against required ACE entries.

Parameters

host System.String requiredposition: 0
facts ComputerX.Controls.CxFacts requiredposition: 1
public virtual Boolean IsApplicable(CxFacts facts) #
Returns: Boolean

True when the control applies to the provided facts.

Parameters

facts ComputerX.Controls.CxFacts requiredposition: 0
public virtual Object ReadCurrent(String host, CxFacts facts) #
Returns: Object

Reads and formats the current DACL of the key into comparison lines.

Parameters

host System.String requiredposition: 0
facts ComputerX.Controls.CxFacts requiredposition: 1
public virtual Boolean TryWrite(String host, Object value, out String error) #
Returns: Boolean

Write is not supported for this control.

Parameters

host System.String requiredposition: 0
value System.Object requiredposition: 1
error System.String@ requiredposition: 2
public RegistryAclControl WhereIs(CxCondition c) #
Returns: RegistryAclControl

Sets an applicability condition.

Parameters

c ComputerX.Controls.CxCondition requiredposition: 0
public RegistryAclControl WithDesired(CxVendor vendor, IEnumerable<String> aceEntries, String ruleId = null, String note = null, String description = null, String referenceUrl = null, String severity = null, String category = null, String[] tags = null) #
Returns: RegistryAclControl

Adds desired ACE entries in the form "Principal|Rights|Allow|Deny|Max".

Parameters

vendor ComputerX.Controls.CxVendor requiredposition: 0
aceEntries System.Collections.Generic.IEnumerable{System.String} requiredposition: 1
ruleId System.String = null optionalposition: 2
note System.String = null optionalposition: 3
description System.String = null optionalposition: 4
referenceUrl System.String = null optionalposition: 5
severity System.String = null optionalposition: 6
category System.String = null optionalposition: 7
tags System.String[] = null optionalposition: 8

Properties

public virtual String Id { get; } #

Unique identifier for the control.

public virtual String Title { get; } #

Display title for the control.

public virtual CxValueKind ValueKind { get; } #

Value kind (string list of ACL lines).

public virtual CxComparator Comparator { get; } #

Comparator semantics (Superset: current must contain all required entries).

public String KeyPath { get; } #

Registry key path (HKLM/HKCU/etc.).

public CxCondition Where { get; set; } #

Optional applicability condition.

public virtual IReadOnlyList<CxDesired> Desired { get; } #

Desired ACE entries as vendor-tagged lists.