IExchangeManageStore::GetRights

The GetRights method obtains the rights that the user has for a folder.

HRESULT GetRights(
  ULONG cbUserEntryIDSize,  
  LPENTRYID lpUserEntryID,  
  ULONG cbEntryIDSize,  
  LPENTREYID lpEntryID, 
  ULONG FAR * pRights   
);

Parameters

cbUserEntryIDSize

Input parameter. The size, in bytes, of the entry identifier in lpUserEntryID.

lpUserEntryID

Input parameter. Points to a MAPI ENTRYID structure, which contains the entry identifier for the user whose rights you want.

cbEntryIDSize

Input parameter. The size, in bytes, of the entry identifier in lpEntryID.

lpEntryID

Input parameter. Points to an ENTRYID structure, which contains the entry identifier for the folder.

pRights

Output parameter. Points to a value containing the rights the user has on the folder:

frightsReadAny: The user can read any of the messages in the folder.
frightsCreate: The user can create a new message in the folder.
frightsEditOwned: The user can edit any message in the folder that they own.
frightsDeleteOwned: The user can delete any message in the folder that they own.
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 new sub-folder in the folder.
frightsOwner: The user owns the folder, and has all rights.
frightsContact: The user is the contact for the folder.

Return Values

See Return Values. In addition, GetRights can return one of the following values:

SUCCESS_SUCCESS: The method completed successfully.
MAPI_E_CALL_FAILED: An unknown error occurred.
MAPI_E_INVALID_PARAMETER: One of the parameters was not valid.
MAPI_E_NO_ACCESS: The user has no permissions on the folder.
MAPI_E_NOT_ENOUGH_MEMORY: There wasn't enough memory to complete the operation.