IExchangeFolderACLs::HrGet
The HrGet method retrieves the access rights for the current member of the ACL and advances the cursor to the next member of the ACL.
HRESULT HrGet(
LPLONG lplRights,
LPSTR FAR * lppszDisplayName,
ULONG FAR * lpcbentryid,
LPENTRYID FAR * lppentyrid
);
Parameters
-
lplRights
-
Output parameter. Points to a LONG variable to hold the ACL rights:
-
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.
-
lppszDisplayName
-
Output parameter. Points to a string containing the display name of the current member of the ACL.
-
lpcbentryid
-
Output parameter. Points to the size, in bytes, of the ENTRYID where lppentyrid points.
-
lppentyrid
-
Output parameter. Points to a MAPI ENTRYID structure that contains the entry identifier of the current member of the ACL.
Return Values
See Return Values.
Remarks
The calling routine must allocate and release the space for the LONG variable where lplRights points and for the ENTRYID structure where lpcbentryid points.
For more information, see ACLEDIT: Modifying an ACL.
See Also
IExchangeFolderACLs