Share via


PermissionObject 接口

提供对 UserPermissionObject 对象的访问以及可以应用于表单的权限设置。

命名空间:  Microsoft.Office.Interop.InfoPath.SemiTrust
程序集:  Microsoft.Office.Interop.InfoPath.SemiTrust(位于 Microsoft.Office.Interop.InfoPath.SemiTrust.dll 中)

语法

声明
<GuidAttribute("096cd6cc-0786-11d1-95fa-0080c78ee3bb")> _
Public Interface PermissionObject _
    Inherits Permission
用法
Dim instance As PermissionObject
[GuidAttribute("096cd6cc-0786-11d1-95fa-0080c78ee3bb")]
public interface PermissionObject : Permission

备注

此类型是用于 Coclass(托管代码需要此 Coclass 来实现 COM 互操作性)的包装。使用此类型来访问由此 Coclass 实现的 COM 接口。有关 COM 接口的信息(包括指向其成员说明的链接),请参阅Permission.

使用 PermissionObject 类及其成员可以限制对活动表单的权限,以及获取或设置特定的权限设置。

与表单模板关联的 Permission 类的实例由 _XDocument3 类的 Permission 属性返回。

备注

由于在 Microsoft InfoPath 中已将 PermissionObject 及其成员添加到 Microsoft.Office.Interop.InfoPath.SemiTrust 对象模型中,因此您必须将 thisXDocument 变量返回的对象转换成 _XDocument3 类型,然后才能访问 PermissionObject 及其成员。有关详细信息,请参阅如何:使用与 InfoPath 2003 不兼容的 Microsoft.Office.Interop.InfoPath.SemiTrust 成员

通过返回的 PermissionObject 对象可以访问与表单模板以及通过该模板创建的每个表单实例关联的 UserPermissionObject 对象。每个 UserPermissionObject 对象都用于为单个用户定义一组特定的权限。虽然通过用户界面授予的某些权限适用于所有用户,但可以使用 UserPermissionObject 对象为各个用户单独指定权限及到期日期。

不论权限是否仅限于活动的表单模板,PermissionObject 对象及其属性和方法都可用。使用 Enabled 属性可以确定表单是否具有受限的权限。

如果用户计算机上未安装 Windows 权限管理客户端,则使用 PermissionObject 对象将引发异常。

通过使用 PermissionObject 对象的属性和方法按以下方式之一来启用表单的权限:

Enabled 属性设置为 true。

设置 DocumentAuthor 属性。

设置 RequestPermissionURL 属性。

StoreLicenses 属性设置为 true 或 false。

调用 ApplyPolicy 方法。

通过使用 Permission 对象的 Add 方法将用户添加到表单,也可以启用表单权限。

备注

在表单处于预览模式时,无法应用权限。因此,在预览表单时,PermissionObject 对象的所有属性都处于只读状态。在预览模式下,Enabled 属性将始终返回 false,如果代码尝试更改此设置,则会引发 System.Runtime.InteropServices.COMException,并返回"该属性/方法在预览模式下不可用"错误。同样,当在预览模式下使用时,与 PermissionObject 和 UserPermissionObject 对象关联的方法也将返回此错误消息。

另请参阅

引用

PermissionObject 成员

Microsoft.Office.Interop.InfoPath.SemiTrust 命名空间