ISecurityInformation2::IsDaclCanonical method (aclui.h)

Article
10/13/2021

The IsDaclCanonical method determines whether the ACEs contained in the specified DACL structure are ordered according to the definition of DACL ordering implemented by the client.

Syntax

BOOL IsDaclCanonical(
  [in] PACL pDacl
);

Parameters

[in] pDacl

A pointer to a discretionary ACL structure initialized by InitializeAcl.

Return value

Returns TRUE if the ACEs contained in the specified DACL structure are ordered according to the definition of DACL ordering implemented by the client.

Returns FALSE if the ACEs are not ordered correctly.

Remarks

If the return value of this method is FALSE, the access control editor displays a message box stating that the DACL is incorrectly ordered. If this method is not provided and the editor requires this information, the editor will check the canonical ordering defined in Order of ACEs in a DACL.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	aclui.h