ACTRL_PROPERTY_ENTRY

[This is preliminary documentation and subject to change.]

The ACTRL_PROPERTY_ENTRY structure stores a list of access-control entries for an object or a specified property on an object.

typedef struct _ACTRL_PROPERTY_ENTRY {
    LPCTSTR                     lpProperty;
    PACTRL_ACCESS_ENTRY_LIST    pAccessEntryList;
    ULONG                       fListFlags;
} ACTRL_PROPERTY_ENTRY, *PACTRL_PROPERTY_ENTRY;
 

Members

lpProperty

Pointer to a null-terminated string that specifies the GUID of a property on an object. You can use the UuidToString function to generate a string representation of a property GUID.

If this member is NULL, the access entry list applies to the object; otherwise, it applies to the specified property.

pAccessEntryList

Pointer to an ACTRL_ACCESS_ENTRY_LIST structure that contains a list of access-control entries.

fListFlags

Flags that specify information about the lpProperty property. This member can be the following value.

Value	Meaning
ACTRL_ACCESS_PROTECTED	Protects the object or property from inheriting access-control entries.

Remarks

To create an ACTRL_PROPERTY_ENTRY structure that grants everyone full access to an object, set the pAccessEntryList member to NULL.

To create an ACTRL_PROPERTY_ENTRY structure that denies all access to an object, set the pAccessEntryList member to point to an ACTRL_ACCESS_ENTRY_LIST structure whose cEntries member is zero and pAccessList member is NULL.

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in accctrl.h.
  Unicode: Defined as Unicode and ANSI structures.

See Also

Access Control Overview, Access Control Structures, ACTRL_ACCESS, ACTRL_ACCESS_ENTRY_LIST, UuidToString