IAccessControl::GetAllAccessRights (Windows CE 5.0)

Send Feedback

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

HRESULT GetAllAccessRights(LPWSTRlpProperty,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_ACCESSW pointer 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 CoTaskMemFree function.

    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 PTRUSTEEW pointer variable that receives a pointer to the owner's TRUSTEEW structure.

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

  • ppGroup
    [out] Address of PTRUSTEEW pointer variable that receives a pointer to the group's TRUSTEEW structure.

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

Return Values

None.

Remarks

The ACTRL_ACCESSW structure is the Unicode-compatible version of the ACTRL_ACCESS structure.

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

Requirements

OS Versions: Windows CE 3.0 and later.
Header: IAccess.h.
Link Library: Ole32.lib, Uuid.lib.

See Also

CoTaskMemFree | IAccessControl::GrantAccessRights | IAccessControl::SetAccessRights

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.