How to set Outlook Folder Description and Folder Homepage URL properties using EWS Managed API?

  • Article

One of our customer is trying to update the Folder Description and Folder Homepage URL properties for Outlook 2007/2010 having mailbox on Exchange 2007/2010.

We could use below mentioned code snippet to set Folder Description property as Extended Property using EWS Managed API.

NOTE: Following programming examples is for illustration only, without warranty either expressed or implied, including, but not limited to, the implied warranties of merchantability and/or fitness for a particular purpose. This sample code assumes that you are familiar with the programming language being demonstrated and the tools used to create and debug procedures. This sample code is provided for the purpose of illustration only and is not intended to be used in a production environment.

<SAMPLE CODE>

public static ExtendedPropertyDefinition FolderDescription = new ExtendedPropertyDefinition(0x3004, MapiPropertyType.String);

Folder fl = new Folder(service);
fl.DisplayName = "Test";
fl.SetExtendedProperty(FolderDescription, "Blogging Mail Folder");
fl.Save(WellKnownFolderName.Inbox);

</SAMPLE CODE>

image

 

In order to set Outlook Folder Homepage URL property(as shown in below snapshot) we could refer Henning Krause post @ https://www.infinitec.de/post/2011/10/05/Setting-the-Homepage-of-an-Exchange-folder-using-the-EWS-Managed-API.aspx

image

IMP: However, We need to keep in mind that, when we set the Outlook Homepage URL within Outlook it configures the PR_FOLDER_WEBVIEWINFO or https://schemas.microsoft.com/mapi/proptag/0x36DF0102  property. This property is a Binary property and its format is UNDOCUMENTED and hence NOT SUPPORTED by Microsoft. The one thing to note is this it is an unsupported thing to do so make sure we do plenty of testing first.

Hope this helps!