PermissionObject Interface

Definição

Namespace:

Microsoft.Office.Interop.InfoPath

Assembly:

Microsoft.Office.Interop.InfoPath.dll

Fornece acesso a UserPermissionObject objetos e configurações de permissão que podem ser aplicadas a um formulário.

public interface class PermissionObject : Microsoft::Office::Interop::InfoPath::Permission

[System.Runtime.InteropServices.Guid("096CD6CC-0786-11D1-95FA-0080C78EE3BB")]
public interface PermissionObject : Microsoft.Office.Interop.InfoPath.Permission

type PermissionObject = interface
    interface Permission

Public Interface PermissionObject
Implements Permission

Derivado

Microsoft.Office.Interop.InfoPath.PermissionObjectClass

Atributos

GuidAttribute

Implementações

Permission

Comentários

This type is a wrapper for a coclass that is required by managed code for COM interoperability. Use this type to access the members of the COM interface implemented by this coclass. Para obter informações sobre a interface COM, incluindo um link para descrições de seus membros, consultePermission.

Use a classe PermissionObject e seus membros para restringir permissões ao formulário ativo e para obter ou definir configurações de permissões específicas.

Uma instância da classe Permission associada a um modelo de formulário é retornada pela Permission propriedade da _XDocument3 classe.

O objeto PermissionObject retornado fornece acesso aos objetos UserPermissionObject associados ao modelo de formulário e a cada instância de formulário criada com esse modelo. Cada objeto UserPermissionObject é usado para definir um conjunto específico de direitos para um usuário individual. Embora algumas permissões concedidas por meio da interface do usuário se apliquem a todos os usuários, você pode usar o objeto UserPermissionObject para atribuir permissão por usuário com datas de validade por usuário.

O objeto PermissionObject e suas propriedades e métodos estão disponíveis se as permissões são restritas no modelo de formulário ativo ou não. Use a Enabled propriedade para determinar se um formulário tem permissões restritas.

Se o cliente do Windows Rights Management não estiver instalado no computador de um usuário, o uso do objeto PermissionObject gerará uma exceção.

As permissões em um formulário são habilitadas de uma das seguintes maneiras usando propriedades e métodos do objeto PermissionObject :

A propriedade Habilitada é definida como true.

A DocumentAuthor propriedade está definida.

A RequestPermissionURL propriedade está definida.

A StoreLicenses propriedade é definida como true ou false.

O ApplyPolicy(String) método é chamado.

As permissões em um formulário também podem ser habilitadas usando o Add(String, Object, Object) método do Permission objeto para adicionar um usuário ao formulário.

Observação: as permissões não podem ser aplicadas quando um formulário está no modo de visualização. Por esse motivo, todas as propriedades do objeto PermissionObject são somente leitura quando um formulário está sendo visualizado. No modo de visualização, a propriedade Habilitada sempre retornará false e, se o código tentar alterar essa configuração, um System.Runtime.InteropServices.COMException será gerado e o erro "A propriedade/método não está disponível no modo de visualização" será retornado. Da mesma forma, os métodos associados aos objetos PermissionObject e UserPermissionObject também retornarão essa mensagem de erro quando usados no modo de visualização.

Propriedades

Count	Obtém o número de UserPermissionObject objetos associados ao formulário. (Herdado de Permission)
DocumentAuthor	Obtém ou define o autor do formulário atual como um endereço de email. (Herdado de Permission)
Enabled	Obtém ou define se as configurações de permissão representadas pelo objeto Permission estão habilitadas para o formulário atual. (Herdado de Permission)
Item[Object]	Obtém o UserPermission objeto no índice especificado. (Herdado de Permission)
PermissionFromPolicy	Obtém se uma política de permissão foi aplicada ao formulário atual. (Herdado de Permission)
PolicyDescription	Obtém uma descrição da política que foi aplicada ao formulário atual. (Herdado de Permission)
PolicyName	Obtém o nome da política que foi aplicada ao formulário atual. (Herdado de Permission)
RequestPermissionURL	Obtém ou define o arquivo, URL ou endereço de email para entrar em contato com usuários que precisam de permissões adicionais no formulário atual. (Herdado de Permission)
StoreLicenses	Obtém ou define se a licença do usuário para exibir o formulário atual deve ser armazenada em cache para permitir a exibição offline quando o usuário não puder se conectar a um servidor de gerenciamento de direitos. (Herdado de Permission)

Métodos

Add(String, Object, Object)	Cria um novo conjunto de permissões no formulário atual para o usuário especificado com as permissões especificadas e uma data de validade. (Herdado de Permission)
ApplyPolicy(String)	Aplica uma política ao formulário usando um arquivo de modelo de política. (Herdado de Permission)
GetEnumerator()	Obtém um IEnumerator para iteração sobre a coleção. (Herdado de Permission)
RemoveAll()	Remove todos os UserPermission objetos associados ao formulário. (Herdado de Permission)