Export (0) Print
Expand All
ACE
ACL
SID
Expand Minimize

SI_ACCESS structure

The SI_ACCESS structure contains information about an access right or default access mask for a securable object. The ISecurityInformation::GetAccessRights method uses this structure to specify information that the access control editor uses to initialize its property pages.

Syntax


typedef struct _SI_ACCESS {
  const GUID  *pguid;
  ACCESS_MASK mask;
  LPCWSTR     pszName;
  DWORD       dwFlags;
} SI_ACCESS, *PSI_ACCESS;

Members

pguid

A pointer to a GUID structure that identifies the type of object to which the access right or default access mask applies. The GUID can identify a property set or property on the object, or a type of child object that can be contained by the object.

If this member points to GUID_NULL, the access right applies to the object itself.

mask

A bitmask that specifies the access right described by this structure. The mask can contain any combination of standard and specific rights, but should not contain generic rights such as GENERIC_ALL.

pszName

A pointer to a null-terminated Unicode string containing a display string that describes the access right.

Alternatively, pszName can be a string resource identifier returned by the MAKEINTRESOURCE macro. Use the ISecurityInformation::GetObjectInformation method to identify the module that contains the string resource.

dwFlags

A set of bit flags that indicate where the access right is displayed. This member can be a combination of the following.

ValueMeaning
SI_ACCESS_SPECIFIC

The access right is displayed on the advanced security pages.

SI_ACCESS_GENERAL

The access right is displayed on the basic security page.

SI_ACCESS_CONTAINER

Indicates an access right that applies only to containers. If this flag is set, the access right is displayed on the basic security page only if the ISecurityInformation::GetObjectInformation method specifies the SI_CONTAINER flag.

SI_ACCESS_PROPERTY

Indicates a property-specific access right. Used with SI_EDIT_PROPERTIES.

 

This member can also specify a combination of the following flags to indicate whether other containers or objects can inherit the access right.

ValueMeaning
CONTAINER_INHERIT_ACE

Other containers that are contained by the primary object inherit the entry.

INHERIT_ONLY_ACE

The ACE does not apply to the primary object to which the ACL is attached, but objects contained by the primary object inherit the entry.

OBJECT_INHERIT_ACE

Noncontainer objects contained by the primary object inherit the entry.

 

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Aclui.h

See also

GUID
ISecurityInformation::GetAccessRights
ISecurityInformation::GetObjectInformation

 

 

Community Additions

ADD
Show:
© 2014 Microsoft