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_IMAP_SETMAILBOXACL 34

IPWORKSEDI_EXTERNAL int IPWORKSEDI_CALL IPWorksEDI_IMAP_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:

lLookup (visible to be listed)
rRead (Can be selected, fetched, searched, and copied)
sKeep seen/unseen information across sessions
wWrite (Store flags other than SEEN and DELETED)
iInsert (Can be appended, and copied into)
pPost (Can send mail to submission address for mailbox)
cCreate (Can create new sub-mailboxes)
dDelete (Store DELETED flag, perform EXPUNGE)
aAdminister (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.)

Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks EDI 2020 C++ Edition - Version 20.0 [Build 8203]