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,
// pointer to the structure to initialize
LPTSTR pTrusteeName, // name of the trustee to put in the
// structure
DWORD AccessPermissions, // access mask to put in the structure
ACCESS_MODE AccessMode, // access mode to put in the structure
DWORD Inheritance // inheritance type to put in the structure
);
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_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. | |
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. |
None.
Windows NT: Requires version 4.0 or later.
Windows: Unsupported.
Windows CE: Unsupported.
Header: Declared in aclapi.h.
Import Library: Use advapi32.lib.
Unicode: Implemented as Unicode and ANSI versions on Windows NT.
Windows NT 4.0 Access Control Overview, Windows NT 4.0 Access-Control Functions, ACE, ACL, EXPLICIT_ACCESS, GetExplicitEntriesFromAcl, SetEntriesInAcl, TRUSTEE