Permission Schnittstelle

Definition

Verwenden Sie das Permission -Objekt zum Einschränken von Berechtigungen für das aktive Dokument und bestimmte berechtigungseinstellungen festzulegen oder zurückzugeben.

public interface class Permission : Microsoft::Office::Core::_IMsoDispObj, System::Collections::IEnumerable
[System.Runtime.InteropServices.Guid("000C0376-0000-0000-C000-000000000046")]
public interface Permission : Microsoft.Office.Core._IMsoDispObj, System.Collections.IEnumerable
[<System.Runtime.InteropServices.Guid("000C0376-0000-0000-C000-000000000046")>]
type Permission = interface
    interface _IMsoDispObj
    interface IEnumerable
Public Interface Permission
Implements _IMsoDispObj, IEnumerable
Attribute
Implementiert

Hinweise

Die Permission-Eigenschaft des Microsoft Office Word 2003 Document-Objekts , des Microsoft Office Excel 2003 Workbook-Objekts und des Microsoft Office PowerPoint 2003 Presentation-Objekts gibt ein Permission-Objekt zurück.

Verwenden Sie die Enabled -Eigenschaft, um zu bestimmen, ob Berechtigungen für das aktive Dokument eingeschränkt sind. Verwenden Sie die Count -Eigenschaft, um die Anzahl der Benutzer mit Berechtigungen zurückzugeben, und die RemoveAll() -Methode, um alle vorhandenen Berechtigungen zurückzusetzen.

Die DocumentAuthorEigenschaften , EnableTrustedBrowser, RequestPermissionURLund StoreLicenses stellen zusätzliche Informationen zu Berechtigungseinstellungen bereit.

Das Permission-Objekt ermöglicht den Zugriff auf eine Auflistung von UserPermission -Objekten. Verwenden Sie das UserPermission-Objekt, um bestimmte Gruppen von Rechten einzelnen Benutzern zuzuordnen. Während einige Berechtigungen, die über die Benutzeroberfläche erteilt werden (z. B. msoPermissionPrint), für alle Benutzer gelten, können Sie das UserPermission-Objekt verwenden, um Berechtigungen individuell pro Benutzer und mit individuellem Ablaufdatum zuzuweisen.

Microsoft Office Information Rights Management unterstützt die Verwendung von administrativen Berechtigungsrichtlinien, die Benutzer und Gruppen sowie deren Dokumentberechtigungen auflisten. Verwenden Sie die ApplyPolicy(String) -Methode, um eine Berechtigungsrichtlinie und die PermissionFromPolicyEigenschaften , PolicyNameund PolicyDescription anzuwenden, um Richtlinieninformationen zurückzugeben.

Das Permission-Objektmodell ist verfügbar, unabhängig davon, ob Berechtigungen für das aktive Dokument eingeschränkt sind. Die Permission-Eigenschaft der Objekte Document, Workbook und Presentation gibt nicht Nothing zurück, wenn das aktive Dokument nicht über eingeschränkte Berechtigungen verfügt. Verwenden Sie die Enabled -Eigenschaft, um zu bestimmen, ob ein Dokument über eingeschränkte Berechtigungen verfügt.

Verwendung des Permission -Objekts löst einen Fehler aus, wenn der Windows-Rechteverwaltungsclient nicht installiert ist.

Eigenschaften

Application

Gibt ein Application-Objekt zurück, das die Containeranwendung für das -Objekt darstellt.

Count

Gibt einen Integer-Wert zurück, der die Anzahl der Elemente in der angegebenen Auflistung angibt.

Creator

Gibt eine 32-Bit-Ganzzahl, die die Anwendung angibt, in der das angegebene Objekt erstellt wurde.

DocumentAuthor

Gibt den Namen des Autors des aktiven Dokuments in E-Mail-Form zurück oder legt den Namen fest.

Enabled

Gibt einen booleschen Wert zurück, der angibt, ob Berechtigungen für das aktive Dokument aktiviert sind, oder legt diesen wert fest.

EnableTrustedBrowser

Gibt die Option zurück, die es einem Benutzer ermöglicht, ein Dokument mit eingeschränkten Berechtigungen in einem Webbrowser anzuzeigen, wenn die entsprechende Clientanwendung nicht installiert ist, oder legt diese Option fest.

Item[Object]

Gibt ein UserPermission -Objekt zurück, das ein Element der Permission Auflistung ist.

Parent

Gibt das Parent-Objekt für das angegebene Objekt zurück.

PermissionFromPolicy

Gibt einen booleschen Wert zurück, der angibt, ob eine Berechtigungsrichtlinie auf das aktive Dokument angewendet wurde.

PolicyDescription

Gibt die Beschreibung der Berechtigungsrichtlinie zurück, die auf das aktive Dokument angewendet wird.

PolicyName

Gibt den Namen der Berechtigungsrichtlinie zurück, die auf das aktive Dokument angewendet wird.

RequestPermissionURL

Gibt die zu besuchende Datei- oder Website-URL oder die E-Mail-Adresse für Benutzer zurück, die zusätzliche Berechtigungen für das aktive Dokument benötigen, oder legt diese fest.

StoreLicenses

Gibt einen booleschen Wert zurück, der angibt, ob die Lizenz des Benutzers zum Anzeigen des aktiven Dokuments zwischengespeichert werden soll, um die Offlineanzeige zu ermöglichen, wenn der Benutzer keine Verbindung mit einem Rights Management-Server herstellen kann.

Methoden

Add(String, Object, Object)

Erstellt einen neuen Berechtigungssatz für das aktive Dokument für den angegebenen Benutzer.

ApplyPolicy(String)

Wendet die angegebene Berechtigungsrichtlinie für das aktive Dokument an.

GetEnumerator()

Verwenden Sie das Permission -Objekt zum Einschränken von Berechtigungen für das aktive Dokument und bestimmte berechtigungseinstellungen festzulegen oder zurückzugeben.

RemoveAll()

Entfernt alle UserPermission Objekte aus der Permission Auflistung des aktiven Dokuments und deaktiviert Einschränkungen für das aktive Dokument.

Gilt für: