IAccessControl::GrantAccessRights (Windows CE 5.0)

Send Feedback

This method merges the new ACTRL_ACCESS list with the existing access rights on the object.

HRESULT GrantAccessRights(PACTRL_ACCESSWpAccessList);

Parameters

  • pAccessList
    [in] Pointer to the ACTRL_ACCESSW list, which contains an array of access lists for the object.

Return Values

None.

Remarks

Merging the new ACTRL_ACCESSW list with the existing access rights ensures that the object will have at least the indicated access rights.

This merge process consists of adding the new denied access rights before the old denied access rights, and the new allowed access rights before the existing allowed rights.

None of the existing rights are removed.

Following a merge, the access rights on an object are ordered as follows:

[New Access Denied]

[Old Access Denied]

[New Access Allowed]

[Old Access Allowed]

The system-supplied implementation of GrantAccessRights (CLSID_DCOMAccessControl) requires that the cEntries member of the ACTRL_ACCESSW structure be set to exactly 1.

In addition, the lpProperty member of the ACTRL_PROPERTY_ENTRYW structure must be NULL to indicate that the access entry list applies to the object itself.

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

IAccessControl::GetAllAccessRights | IAccessControl::SetAccessRights

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.