EditSecurityAdvanced function (aclui.h)

The EditSecurityAdvanced function extends the EditSecurity function to include the security page type when displaying the 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 access control entries (ACEs) in an object's discretionary access control list (DACL).

Syntax

HRESULT ACLUIAPI EditSecurityAdvanced(
  [in] HWND           hwndOwner,
  [in] LPSECURITYINFO psi,
  [in] SI_PAGE_TYPE   uSIPage
);

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.

[in] uSIPage

A value of the SI_PAGE_TYPE enumeration that indicates the page type on which to display the elevated access control editor.

Return value

If the function succeeds, the return value is S_OK.

If the function fails, any other HRESULT value indicates an error. For a list of common error codes, see Common HRESULT Values.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header aclui.h
Library Aclui.lib
DLL Aclui.dll

See also

Access Control Editor

Access Control Editor Functions

CreateSecurityPage

EditSecurity

GetSecurity

ISecurityInformation

SetSecurity