IExchangeFolderACLs::HrModify

The HrModify method sets the access rights for the current member of the ACL.

HRESULT HrModify(
  LONG lRights,      
  LPLONG lplRights   
);
 

Parameters

lRights
Input parameter. The rights that are requested for the current member of the ACL:
frightsReadAny
The user can read any message in the folder.
frightsCreate
The user can create a message in the folder.
frightsEditOwned
The user can edit any message that they own in the folder.
frightsDeleteOwned
The user can delete any message that they own in the folder.
frightsEditAny
The user can edit any message in the folder.
frightsDeleteAny
The user can delete any message in the folder.
frightsCreateSubfolder
The user can create a subfolder in the folder.
frightsOwner
The user owns the folder.
frightsContact
The user is the contact person for the folder. Note: This is not part of rightsAll.
rightsNone
The user has no rights in the folder.
rightsReadOnly
The user can only read messages in the folder. Equivalent to frightsReadAny.
rightsReadWrite
The user can read or edit any message in the folder. Equivalent to frightsReadAny | frightsEditAny.
rightsAll
The user has all rights on the folder.
lplRights
Input and output parameter. Points to a LONG value containing the rights granted to the current member of the ACL. If you aren't concerned about whether the granted rights are the same as the requested rights, set this value to NULL.

Return Values

See Return Values.

Remarks

Rights that are granted may not be the same as the rights that were requested because some rights may not be allowed and the Microsoft Exchange Server information store often sets extra bits.

You can change the default rights given to all new members of the folder when they are added to the ACL by using this method and setting the rights of the default rights member of the ACL. Use the HrSeek method with the ACL_POS_DEFAULT argument to select the default rights member of the ACL.

The owner of the folder initially has only default rights on the folder. Use the HrSeek method with the ACL_POS_CREATOR argument to select the owner of the ACL.

For more information, see ACLEDIT: Modifying an ACL.

See Also

IExchangeFolderACLs