Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This method gets the entire list of access rights and/or the owner and group for the specified object.

Syntax 

HRESULT GetAllAccessRights(
  LPWSTR 
lpProperty, 
  PACTRL_ACCESSW* 
ppAccessList, 
  PTRUSTEEW* 
ppOwner, 
  PTRUSTEEW* 
ppGroup 
);

Parameters

lpProperty

[in] Name of the property. If you are using the COM implementation of IAccessControl, this parameter must be NULL.

ppAccessList

[out] Address of PACTRL_ACCESSWpointer variable that receives a pointer to the access list structure.

May not be NULL.

If the call succeeds, the caller must free the allocated memory with the CoTaskMemFreefunction.

Note that the memory is allocated (all_nodes), which means that all the substructures are allocated in one block. Therefore, the entire data structure must be freed by a single call to CoTaskMemFree.

ppOwner

[out] Address of PTRUSTEEWpointer variable that receives a pointer to the owner's TRUSTEEWstructure.

If this parameter is not NULL and the function succeeds, the caller must free the memory with CoTaskMemFree.

ppGroup

[out] Address of PTRUSTEEWpointer variable that receives a pointer to the group's TRUSTEEWstructure.

If this parameter is not NULL and the function succeeds, the caller must free the memory with CoTaskMemFree.

Return Value

None.

Remarks

The ACTRL_ACCESSWstructure is the Unicode-compatible version of the ACTRL_ACCESSstructure.

To determine whether the platform supports this interface, see Determining Supported COM APIs.

Requirements

Header iaccess.h
Library ole32.lib, uuid.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also