Platform SDK: Access Control

ISecurityInformation

The ISecurityInformation interface enables the access control editor to communicate with the caller of the CreateSecurityPage and EditSecurity functions. The editor calls the interface methods to retrieve information used to initialize its pages and to determine the editing options available to the user. The editor also calls the interface methods to pass the user's input back to the application.

The LPSECURITYINFO type is a pointer to an ISecurityInformation object.

When to Implement

You must implement the ISecurityInformation interface if you use the CreateSecurityPage or EditSecurity functions.

When to Use

Applications do not call the ISecurityInformation methods. The system calls the interface methods to communicate with application that called CreateSecurityPage or EditSecurity.

Methods in Vtable Order

IUnknown Methods

QueryInterface
AddRef
Release

ISecurityInformation Methods

Method	Description
GetObjectInformation	Requests information used to initialize the access control editor and to determine the editing options available to the user.
GetSecurity	Requests the security descriptor of the object being edited.
SetSecurity	Provides a security descriptor containing the security information specified by the user.
GetAccessRights	Requests information about the access rights supported by the object being edited.
MapGeneric	Requests that the generic access rights in an access mask be mapped to their corresponding standard and specific access rights.
GetInheritTypes	Requests information about how the object's ACEs can be inherited by child objects.
PropertySheetPageCallback	Notifies the application that an access control editor property page is being created or destroyed.

Requirements