Platform SDK: Access Control |
The BuildExplicitAccessWithName function initializes an EXPLICIT_ACCESS structure with data specified by the caller. The trustee is identified by a name string.
VOID BuildExplicitAccessWithName( PEXPLICIT_ACCESS pExplicitAccess, // structure LPTSTR pTrusteeName, // trustee name DWORD AccessPermissions, // access mask ACCESS_MODE AccessMode, // access mode DWORD Inheritance // inheritance type );
Member | Value |
---|---|
pMultipleTrustee | NULL |
MultipleTrusteeOperation | NO_MULTIPLE_TRUSTEE |
TrusteeForm | TRUSTEE_IS_NAME |
TrusteeType | TRUSTEE_IS_UNKNOWN |
Value | Meaning |
---|---|
CONTAINER_INHERIT_ACE | Other containers that are contained by the primary object inherit the ACE. |
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 ACE. |
NO_PROPAGATE_INHERIT_ACE | The OBJECT_INHERIT_ACE and CONTAINER_INHERIT_ACE flags are not propagated to an inherited ACE. |
OBJECT_INHERIT_ACE | Noncontainer objects contained by the primary object inherit the ACE. |
SUB_CONTAINERS_AND_OBJECTS_INHERIT | Both containers and noncontainer objects that are contained by the primary object inherit the ACE. This flag corresponds to the combination of the CONTAINER_INHERIT_ACE and OBJECT_INHERIT_ACE flags. |
SUB_CONTAINERS_ONLY_INHERIT | Other containers that are contained by the primary object inherit the ACE. This flag corresponds to the CONTAINER_INHERIT_ACE flag. |
SUB_OBJECTS_ONLY_INHERIT | Noncontainer objects contained by the primary object inherit the ACE. This flag corresponds to the OBJECT_INHERIT_ACE flag. |
This function does not return a value.
Windows NT/2000: Requires Windows NT 4.0 or later.
Header: Declared in Aclapi.h.
Library: Use Advapi32.lib.
Unicode: Implemented as Unicode and ANSI versions on Windows NT/2000.
Access Control Overview, Access Control Functions, ACE, ACL, EXPLICIT_ACCESS, GetExplicitEntriesFromAcl, SetEntriesInAcl, TRUSTEE