Please ensure Javascript is enabled for purposes of website accessibility
Powered by Zoomin Software. For more details please contactZoomin

AF SDK Reference

AFSecurityOperation Enumeration

  • Last UpdatedNov 18, 2025
  • 3 minute read
AFSecurityOperation Enumeration
The operation used when adding user security rights to objects.

Namespace:  OSIsoft.AF
Assembly:  OSIsoft.AFSDK (in OSIsoft.AFSDK.dll) Version: 3.1.1.1182

Syntax

public enum AFSecurityOperation
Public Enumeration AFSecurityOperation

Dim instance As AFSecurityOperation
public enum class AFSecurityOperation
type AFSecurityOperation

Members

  Member nameValueDescription
Replace0

Add new ACE and replace existing ACE with the following behaviors:

When adding an access ACE:

  • Access ACE for the user already exists, the existing ACE is replaced with the new ACE.
  • Deny ACE for the user already exists, the existing deny ACE is removed and the new access ACE is added.
When adding a deny ACE:
  • Access ACE for the user already exists, the existing access ACE is removed and the new deny ACE is added.
  • Deny ACE for the user already exists, the existing ACE is replaced with the new ACE.

Update4 Add new ACE and update existing ACE. Behaves exactly same as Replace operation except the full list of access and deny rights must be supplied or they will be removed.
Merge1

Add new ACE and merge existing ACE with the following behaviors:

When adding an access ACE:

  • Access ACE for the user already exists, the existing ACE is combined with the new ACE.
  • Deny ACE for the user already exists, the new access ACE is added behind the existing deny ACE. Any security rights being added that were previously denied are removed from the existing deny ACE.
When adding a deny ACE:
  • Access ACE for the user already exists, the new deny ACE is added in front of the existing access ACE. Any security rights being denied that were previously allowed are removed from the existing access ACE.
  • Deny ACE for the user already exists, the existing ACE is combined with the new ACE.

NoReplace2 Only add new ACE if an existing ACE does not exist.

Remarks

This enumeration is used by the AddUser Overload and AddIdentity Overload methods to add security rights for a user or identity to existing objects.

Version Information

AFSDK

Supported in: 3.1.1, 3.1.0, 3.0.2, 3.0.1, 3.0.0, 2.10.11, 2.10.5, 2.10.0, 2.10, 2.9.5, 2.9, 2.8.5, 2.8, 2.7.5, 2.7, 2.6

See Also

In This Topic
Related Links
TitleResults for “How to create a CRG?”Also Available in