_SharingItem.PermissionTemplateGuid Property

Returns or sets a String (string in C#) value that represents the GUID of the template file to apply to the SharingItem in order to specify Information Rights Management (IRM) permissions. Read/write.

Namespace:  Microsoft.Office.Interop.Outlook
Assembly:  Microsoft.Office.Interop.Outlook (in Microsoft.Office.Interop.Outlook.dll)

string PermissionTemplateGuid { get; set; }

Property Value

Type: System.String

This property complements the IRM properties on a SharingItem object; that is, the Permission property and the PermissionService properties.

In particular, the PermissionTemplateGuid property should be synchronized with the Permission property to accurately reflect the permission status of the SharingItem. Setting the PermissionTemplateGuid property to a valid GUID should also incur setting the Permission property to olPermissionTemplate.

An empty string value for the PermissionTemplateGuid property means that there is no permission template file specified for the SharingItem. For example, if no IRM has been set up (in which case the Permission property is olUnrestricted), or the restriction is not to forward the SharingItem (in which case the Permission property is olDoNotForward).

If you attempt to set the PermissionTemplateGuid property for a received message (that is, the Sent property of the SharingItem is True), Microsoft Outlook returns an error.