_MailItem.PermissionTemplateGuid Property

Returns or sets a String (string in C#) value that represents the GUID of the template file to apply to the MailItem 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)

Syntax

'Declaration
<DispIdAttribute()> _
Property PermissionTemplateGuid As String
    Get
    Set
'Usage
Dim instance As _MailItem
Dim value As String

value = instance.PermissionTemplateGuid

instance.PermissionTemplateGuid = value
[DispIdAttribute()]
string PermissionTemplateGuid { get; set; }

Property Value

Type: System.String

Remarks

This property complements the IRM properties on a MailItem 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 MailItem. 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 MailItem. 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 MailItem (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 MailItem is True), Microsoft Outlook returns an error.

See Also

Reference

_MailItem Interface

_MailItem Members

Microsoft.Office.Interop.Outlook Namespace