HrFolderACLsOpen

The HrFolderACLsOpen function retrieves a pointer to an object that implements the IExchangeFolderACLs interface.

Quick Info

Header file: ACLCLS.H
Library: ACLCLS.LIB
Unicode: 

HRESULT HrFolderACLsOpen(
  LPMDB lpMDB,                      
  ULONG cbentryid,                  
  LPENTRYID lpentryid,              
  LPFOLDERACLS FAR * lppFolderACLs  
);

Parameters

lpMDB
Input parameter. Points to a MAPI IMsgStore interface containing the information store with the target folder.
cbentryid
Input parameter. Specifies the number of bytes in lpentryid.
lpentryid
Input parameter. Points to the entry identifier of the folder whose access control list (ACL) will be accessed.
lppFolderACLs
Output parameter. Points to a pointer to the IExchangeFolderACLs interface for the ACL. Returns NULL, if none.

Return Values

See Return Values. In addition, HrFolderACLsOpen can return the following value:

E_NOINTERFACE
The ACL table does not exist.

Remarks

The methods of the IExchangeFolderACLs interface returned by the HrEventOpenLog function can be used to manipulate the ACL on the folder. You can obtain the entry identifier for lpentryid with either the HrMAPIFindFolderEx function (for public information store folders) or the IMsgStore::GetReceiveFolder method (for a user's Inbox folder).

For more information on this function, see Manipulating ACLs.

For information on the IMsgStore interface, see the MAPI Programmer's Reference.

See Also

HrEventOpenLog, HrMAPIFindFolderEx