SetMailboxACL Method
Sets mailbox access control rights for a specific user.
Syntax
ANSI (Cross Platform) int SetMailboxACL(const char* lpszUser, const char* lpszRights); Unicode (Windows) INT SetMailboxACL(LPCWSTR lpszUser, LPCWSTR lpszRights);
- (void)setMailboxACL:(NSString*)user :(NSString*)rights;
#define MID_PIMAP_SETMAILBOXACL 35 IPWORKSOPENPGP_EXTERNAL int IPWORKSOPENPGP_CALL IPWorksOpenPGP_PIMAP_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);
Remarks
This method changes the access control list for the mailbox specified in the Mailbox property so that User is granted the permissions specified in Rights.
Rights is a string containing an optional plus ("+") or minus ("-") prefix, followed by zero or more rights characters. If the string starts with a plus, the rights are added to any existing rights for the identifier. If the string starts with a minus, the rights are removed from any existing rights for the identifier. If the string does not start with a plus or minus, the rights replace any existing rights for the identifier.
Standard rights include:
l | Lookup (visible to be listed) |
r | Read (Can be selected, fetched, searched, and copied) |
s | Keep seen/unseen information across sessions |
w | Write (Store flags other than SEEN and DELETED) |
i | Insert (Can be appended, and copied into) |
p | Post (Can send mail to submission address for mailbox) |
c | Create (Can create new sub-mailboxes) |
d | Delete (Store DELETED flag, perform EXPUNGE) |
a | Administer (Set access permissions) |
Error Handling (C++)
This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)