Permission.ApplyPolicy Method (Microsoft.Office.InfoPath)

  • Article

Applies a policy to the form using a policy template file.

Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Syntax

'Declaration
Public MustOverride Sub ApplyPolicy ( _
    filename As String _
)
'Usage
Dim instance As Permission
Dim filename As String

instance.ApplyPolicy(filename)

public abstract void ApplyPolicy (
    string filename
)

Parameters

  • filename
    The path and file name of an Extensible Rights Markup Language (XRML) file that defines users and groups and permissions to apply to the form template.

Exceptions

Exception type Condition

ArgumentNullException

The parameter passed to this method is null.

ArgumentException

The parameter passed to this method isnot valid. For example, it is of the wrong type or format.

Remarks

To view an example of the format of an XRML file that is used as a policy template file, see Sample End-User License in the Rights Management Services SDK.

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed only from code running in forms opened in Microsoft Office InfoPath 2007.

Example

In the following example, clicking the Button control applies a policy template file that allows the user to edit, but not copy the current form.

public void CTRL1_Clicked(object sender, ClickedEventArgs e)
{
   this.Permission.ApplyPolicy(
      "\\\\MyShare\\Templates\\Edit_but_not_copy.xml");
}

Public Sub CTRL1_Clicked(ByVal sender As Object, _
   Me.Permission.ApplyPolicy( _
      "\\MyShare\Templates\Edit_but_not_copy.xml")

End Sub

See Also

Reference

Permission Class
Permission Members
Microsoft.Office.InfoPath Namespace