EditSecurity function (aclui.h)

Article
10/13/2021

The EditSecurity function displays a property sheet that contains a basic security property page. This property page enables the user to view and edit the access rights allowed or denied by the ACEs in an object's DACL.

Syntax

BOOL ACLUIAPI EditSecurity(
  [in] HWND           hwndOwner,
  [in] LPSECURITYINFO psi
);

Parameters

[in] hwndOwner

A handle to the window that owns the property sheet. This parameter can be NULL.

[in] psi

A pointer to your implementation of the ISecurityInformation interface. The system calls the interface methods to retrieve information about the object being edited and to return the user's input.

Return value

If the function succeeds, the return value is a nonzero value.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The EditSecurity function calls the CreateSecurityPage function to create a basic security property page.

During the property page initialization, the system calls the ISecurityInformation::GetSecurity and ISecurityInformation::SetSecurity methods to determine whether the user has permission to edit the object's security descriptor. The system displays an error message if the user does not have permission.

The basic security property page can include an Advanced button for displaying the advanced security property sheet. This advanced security property sheet can contain three additional property pages that enable the user to view and edit the object's DACL, SACL, and owner.

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
Library	Aclui.lib
DLL	Aclui.dll