PermissionObject-Schnittstelle

Stellt den Zugriff auf UserPermissionObject-Objekte sowie Berechtigungseinstellungen bereit, die auf ein Formular angewendet werden können.

  Der CLS-kompatible Alternative ist .

Namespace: Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly: Microsoft.Office.Interop.InfoPath.SemiTrust (in microsoft.office.interop.infopath.semitrust.dll)

Syntax

<CLSCompliantAttribute(False)> _
<GuidAttribute("096cd6cc-0786-11d1-95fa-0080c78ee3bb")> _
<CoClassAttribute(GetType(PermissionObjectWrapper))> _
Public Interface PermissionObject
    Inherits Permission

Dim instance As PermissionObject

[CLSCompliantAttribute(false)] 
[GuidAttribute("096cd6cc-0786-11d1-95fa-0080c78ee3bb")] 
[CoClassAttribute(typeof(PermissionObjectWrapper))] 
public interface PermissionObject : Permission

Hinweise

Dies ist ein Wrappertyp für eine Coklasse, die für den verwalteten Code der COM-Interoperabilität erforderlich ist. Verwenden Sie diesen Typ zum Zugreifen auf die Member der COM-Schnittstelle, die von der Coklasse implementiert wurden. Informationen zur COM-Schnittstelle, einschließlich eines Links zu den Memberbeschreibungen, finden Sie unter Permission.

Verwenden Sie die PermissionObject-Klasse und deren Member, um die Berechtigungen auf das aktive Formular einzuschränken und bestimmte Berechtigungseinstellungen abzurufen oder festzulegen.

Eine Instanz der einer Formularvorlage zugeordneten Permission-Klasse wird von der Permission-Eigenschaft der _XDocument3-Klasse zurückgegeben.

Hinweis:

Da die PermissionObject-Klasse und ihre Member zum Microsoft.Office.Interop.InfoPath.SemiTrust -Objektmodell in Microsoft Office InfoPath 2007 hinzugefügt wurden, müssen Sie das von der thisXDocument-Variable zurückgegebene Objekt in den _XDocument3-Typ umwandeln, bevor Sie auf die PermissionObject-Klasse und ihre Member zugreifen können. Weitere Informationen hierzu finden Sie unter Vorgehensweise: Verwenden von nicht mit InfoPath 2003 kompatiblen Microsoft.Office.Interop.InfoPath.SemiTrust-Membern.

Das zurückgegebene PermissionObject-Objekt ermöglicht den Zugriff auf die der Formularvorlage zugeordneten UserPermissionObject-Objekte und auf jede mit dieser Vorlage erstellte Formularinstanz. Jedes UserPermissionObject-Objekt dient zum Definieren einer bestimmten Regelgruppe für einen einzelnen Benutzer. Während einige Berechtigungen, die über die Benutzeroberfläche erteilt werden, auf alle Benutzer angewendet werden, können Sie das UserPermissionObject-Objekt verwenden, um die Berechtigung auf einer benutzerbezogenen Basis mit benutzerbezogenem Ablaufdatum zuzuweisen.

Das PermissionObject-Objekt und seine Eigenschaften und Methoden sind unabhängig davon verfügbar, ob die Berechtigungen für die aktive Formularvorlage eingeschränkt sind oder nicht. Mithilfe der Enabled-Eigenschaft können Sie bestimmen, ob ein Formular eingeschränkte Berechtigungen hat.

Wenn der Windows-Rechteverwaltungsclient nicht auf einem Benutzercomputer installiert ist, löst die Verwendung des PermissionObject-Objekts eine Ausnahme aus.

Berechtigungen für ein Formular werden auf eine der folgenden Arten mithilfe von Eigenschaften und Methoden des PermissionObject-Objekts aktiviert:

Die Enabled-Eigenschaft ist auf true festgelegt.

Die DocumentAuthor-Eigenschaft ist festgelegt.

Die RequestPermissionURL-Eigenschaft ist festgelegt.

Die StoreLicenses-Eigenschaft ist auf true oder false festgelegt.

Die ApplyPolicy-Methode wird aufgerufen.

Berechtigungen auf einem Formular können auch mithilfe der Add-Methode des Permission-Objekts zum Hinzufügen eines Benutzers zum Formular aktiviert werden.

Hinweis:

Berechtigungen können nicht angewendet werden, wenn sich ein Formular im Vorschaumodus befindet. Aus diesem Grund sind alle Eigenschaften des PermissionObject-Objekts schreibgeschützt, wenn die Vorschau für ein Formular angezeigt wird. Im Vorschaumodus gibt die Enabled-Eigenschaft immer false zurück, und wenn der Code versucht, diese Einstellung zu ändern, wird System.Runtime.InteropServices.COMException ausgelöst und der Fehler "Die Eigenschaft/Methode ist im Vorschaumodus nicht verfügbar" zurückgegeben. Auf ähnliche Weise geben die Methoden, die den Objekten PermissionObject und UserPermissionObject zugeordnet sind, diese Fehlermeldung zurück, wenn sie im Vorschaumodus verwendet werden.

Siehe auch

Referenz

PermissionObject-Member
Microsoft.Office.Interop.InfoPath.SemiTrust-Namespace