PermissionObject インターフェイス
フォームに適用できる UserPermissionObject オブジェクトおよびアクセス許可の設定にアクセスできるようにします。
名前空間: Microsoft.Office.Interop.InfoPath
アセンブリ: Microsoft.Office.Interop.InfoPath (microsoft.office.interop.infopath.dll 内)
構文
'宣言
<GuidAttribute("096CD6CC-0786-11D1-95FA-0080C78EE3BB")> _
<CoClassAttribute(GetType(PermissionObjectClass))> _
Public Interface PermissionObject
Inherits Permission
'使用
Dim instance As PermissionObject
[GuidAttribute("096CD6CC-0786-11D1-95FA-0080C78EE3BB")]
[CoClassAttribute(typeof(PermissionObjectClass))]
public interface PermissionObject : Permission
コメント
この型は、COM 相互運用のためにマネージ コードで必要とされるコクラスのラッパーです。この型を使用して、このコクラスによって実装される COM インターフェイスのメンバにアクセスします。COM インターフェイスについては (このメンバの説明へのリンクを含む)、次を参照してください Permission.
アクティブなフォームへのアクセス許可を制限し、特定のアクセス許可の設定を取得または指定したりするには、PermissionObject クラスおよびそのメンバを使用します。
フォーム テンプレートに関連付けられた Permission クラスのインスタンスは、_XDocument3 クラスの Permission プロパティによって返されます。
返される PermissionObject オブジェクトでは、フォーム テンプレートとそのテンプレートで作成された各フォーム インスタンスに関連する UserPermissionObject オブジェクトにアクセスできます。各 UserPermissionObject オブジェクトは、個別のユーザーのアクセス許可のセットを定義するために使用します。ユーザー インターフェイスを通じて付与される一部のアクセス許可はすべてのユーザーに適用されますが、UserPermissionObject オブジェクトを使用すると、ユーザーおよびその有効期限日ごとにアクセス許可を割り当てることができます。
PermissionObject オブジェクトおよびそのプロパティとメソッドは、アクティブなフォーム テンプレートでアクセス許可が制限されているかどうかにかかわらず利用できます。フォームのアクセス許可が制限されているかどうかを判断するには、Enabled プロパティを使用します。
Windows Rights Management クライアントがユーザーのコンピュータにインストールされていない場合は、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 名前空間