CreateSecurityPage function (aclui.h)

The CreateSecurityPage function creates a basic security property page that enables the user to view and edit the access rights allowed or denied by the access control entries (ACEs) in an object's discretionary access control list (DACL). Use the PropertySheet function or the PSM_ADDPAGE message to add this page to a property sheet.

Syntax

HPROPSHEETPAGE ACLUIAPI CreateSecurityPage(
  [in] LPSECURITYINFO psi
);

Parameters

[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 function returns a handle to a basic security property page.

If the function fails, it returns NULL. To get extended error information, call GetLastError.

Remarks

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, system access control list (SACL), and owner.

Requirements

See also

Access Control Editor

Access Control Editor Functions

EditSecurity

GetSecurity

ISecurityInformation

PSM_ADDPAGE

PropertySheet

SetSecurity