Active Directory Rights Management Services SDK

Übersicht über die Active Directory Rights Management Services SDK-Technologie.

Zum Entwickeln des Active Directory Rights Management Services SDK benötigen Sie die folgenden Header:

• msdrm.h
• msdrmdefs.h

Programmieranleitungen für diese Technologie finden Sie unter:

• Active Directory Rights Management Services SDK

Enumerationen

DRM_DISTRIBUTION_POINT_INFO Gibt den Typ des Verteilungspunkts an, der Informationen zum Aufrufen von DRMGetIssuanceLicenseInfo abruft.
DRM_STATUS_MSG Wird von der benutzerdefinierten Rückruffunktion verwendet, um anzugeben, warum die Rückruffunktion aufgerufen wird.
DRM_USAGEPOLICY_TYPE Wird zusammen mit den Funktionen DRMGetUsagePolicy und DRMSetUsagePolicy verwendet, um einen Typ von Verwendungsrichtlinie anzugeben.
DRMATTESTTYPE Die DRMATTESTTYPE-Aufzählung gibt an, welche Art von Signatur für ein Datenblob erstellt werden soll.
DRMENCODINGTYPE Die DRMENCODINGTYPE-Aufzählung identifiziert mögliche Codierungstypen, die in Lizenzen verwendet werden.
DRMGLOBALOPTIONS Definiert Werte für die Angabe, welches Protokoll für das Transportprotokoll verwendet wird und ob die Server-Lockbox verwendet wird. Diese Aufzählung wird von der DRMSetGlobalOptions-Funktion verwendet.
DRMSECURITYPROVIDERTYPE Die DRMSECURITYPROVIDERTYPE-Aufzählung gibt den Typ der verwendeten sicheren DRM-Umgebung an.
DRMSPECTYPE Die DRMSPECTYPE-Aufzählung gibt an, welche Art von Sicherheits- oder Bibliotheksanbietern verwendet werden.
DRMTIMETYPE Die DRMTIMETYPE-Aufzählung gibt einen Zeittyp an.

Funktionen

DRMAcquireAdvisories Ruft Sperrlisten ab, die von einer übermittelten Lizenz benötigt werden.
DRMAcquireIssuanceLicenseTemplate Ruft asynchron Ausstellungslizenzvorlagen von einem Server ab.
DRMAcquireLicense Versucht, asynchron eine Endbenutzerlizenz oder ein Client-Lizenzgeberzertifikat zu erwerben.
DRMActivate Ruft ein Lockbox- und Computerzertifikat für einen Computer oder ein Rechtekontozertifikat für einen Benutzer ab.
DRMAddLicense Fügt dem temporären oder dauerhaften Lizenzspeicher eine Endbenutzerlizenz hinzu.
DRMAddRightWithUser Weist einem Benutzer in einer Ausstellungslizenz ein Recht zu.
DRMAttest Die DRMAttest-Funktion wird nicht mehr unterstützt und gibt E_NOTIMPL zurück.
DRMCALLBACK Einige der funktionen, die im AD RMS SDK enthalten sind, stellen Statusinformationen und Lizenzen für Ihre Anwendung mithilfe einer Rückruffunktion bereit, die Sie implementieren müssen. Die Rückrufsyntax wird unten angezeigt.
DRMCheckSecurity Gibt S_OK für eine beliebige Ebene der ausgeführten Sicherheitsüberprüfung zurück.
DRMClearAllRights Entfernt alle Rechte aus einer vorhandenen Ausstellungslizenz.
DRMCloseEnvironmentHandle Schließt ein Umgebungshandle.
DRMCloseHandle Schließt handles to objects created with DRMCreate* functions and libraries loaded by using DRMLoadLibrary.
DRMClosePubHandle Schließt ein zuvor erstelltes DRMPUBHANDLE-Element.
DRMCloseQueryHandle Schließt ein Handle für ein ungebundenes Lizenzobjekt.
DRMCloseSession Schließt eine Clientsitzung oder eine Lizenzspeichersitzung.
DRMConstructCertificateChain Erstellt eine Zertifikatkette aus einer beliebigen Anzahl von Zertifikaten.
DRMCreateBoundLicense Ermöglicht einer Anwendung, die Rechte einer lokal gespeicherten Lizenz zu untersuchen oder auszuüben.
DRMCreateClientSession Erstellt eine Clientsitzung, die Lizenzspeichersitzungen hosten und in Aktivierungs- und anderen Funktionsaufrufen verwendet wird.
DRMCreateEnablingBitsDecryptor Erstellt ein Entschlüsselungsobjekt, das zum Entschlüsseln von Inhaltsdaten verwendet wird.
DRMCreateEnablingBitsEncryptor Erstellt ein AD RMS-verschlüsselungsobjekt, das zum Verschlüsseln von Inhaltsdaten verwendet wird.
DRMCreateEnablingPrincipal Erstellt einen aktivierungsfähigen Prinzipal, der zum Binden an eine Lizenz erforderlich ist.
DRMCreateIssuanceLicense Erstellt eine Veröffentlichungslizenz von Grund auf neu, aus einer Vorlage oder aus einer signierten Ausstellungslizenz.
DRMCreateLicenseStorageSession Erstellt eine Lizenzspeichersitzung, die zum Abrufen oder Bearbeiten einer Lizenz erforderlich ist.
DRMCreateRight Erstellt ein XrML-Recht, das einem Benutzer oder einer Gruppe gewährtes Recht definiert.
DRMCreateUser Erstellt einen Benutzer, dem ein Recht gewährt wird.
DRMDecode Decodiert eine Zeichenfolge, die mit einem allgemeinen Algorithmus codiert ist, z. B. base64.
DRMDeconstructCertificateChain Ruft ein angegebenes Zertifikat aus einer Zertifikatkette ab.
DRMDecrypt Entschlüsselt verschlüsselte Inhalte.
DRMDeleteLicense Löscht eine Lizenz, ein Client-Lizenzgeberzertifikat, eine Sperrliste oder eine Ausstellungslizenzvorlage.
DRMDuplicateEnvironmentHandle Erstellt eine Kopie eines Umgebungshandles.
DRMDuplicateHandle Erstellt eine Kopie eines DRMHANDLE.
DRMDuplicatePubHandle Erstellt eine Kopie eines DRMPUBHANDLE.
DRMDuplicateSession Dupliziert eine Client- oder Lizenzspeichersitzung.
DRMEncode Codiert Daten mithilfe einer öffentlichen Codierungsmethode, z. B. base64.
DRMEncrypt Verschlüsselt Daten.
DRMEnumerateLicense Listet gültige Lizenzen, Computerzertifikate oder Rechtekontozertifikate, Sperrlisten für den aktuellen Benutzer oder Ausstellungslizenzvorlagen auf.
DRMGetApplicationSpecificData Ruft ein Name-Wert-Paar beliebiger anwendungsspezifischer Informationen ab.
DRMGetBoundLicenseAttribute Ruft ein gebundenes Lizenz-Attribut aus der Lizenz XrML ab.
DRMGetBoundLicenseAttributeCount Ruft die Anzahl der Vorkommen eines Attributs in einer Lizenz ab.
DRMGetBoundLicenseObject Gibt ein Objekt aus einer gebundenen Lizenz zurück.
DRMGetBoundLicenseObjectCount Ruft die Anzahl der Vorkommen eines Objekts innerhalb einer angegebenen Verzweigung einer Lizenz ab.
DRMGetCertificateChainCount Ruft die Anzahl der Zertifikate in einer Zertifikatkette ab.
DRMGetClientVersion Gibt die Versionsnummer der Active Directory Rights Management Services-Clientsoftware zurück und gibt an, ob die Hierarchie für Produktions- oder Vorproduktionszwecke bestimmt ist.
DRMGetEnvironmentInfo Gibt Informationen zu einer sicheren Umgebung zurück.
DRMGetInfo Ruft Informationen zum Verschlüsseln oder Entschlüsseln von Objekten ab.
DRMGetIntervalTime Ruft die Anzahl von Tagen ab der Ausstellung ab, die vor einem Ende bestehen kann – Die Benutzerlizenz muss erneuert werden.
DRMGetIssuanceLicenseInfo Ruft verschiedene Informationen aus einer Ausstellungslizenz ab.
DRMGetIssuanceLicenseTemplate Ruft eine Ausstellungslizenzvorlage aus einer vorhandenen Ausstellungslizenz ab.
DRMGetMetaData Ruft Metadaten aus einer Ausstellungslizenz ab.
DRMGetNameAndDescription Ruft einen sprachspezifischen Namen und eine Beschreibung aus einer Ausstellungslizenz ab.
DRMGetOwnerLicense Ruft eine Besitzerlizenz ab, die durch Aufrufen des DRMGetSignedIssuanceLicense erstellt wurde.
DRMGetProcAddress Gibt die Adresse einer Funktion in einer Bibliothek zurück. Es ist die sichere Version der GetProcAddress-Funktion.
DRMGetRevocationPoint Ruft Informationen zum Sperrpunkt für eine Ausstellungslizenz ab.
DRMGetRightExtendedInfo Ruft benutzerdefinierte Name-Wert-Paare ab, die rechts angefügt sind.
DRMGetRightInfo Ruft Informationen zu einem zuvor erstellten Recht ab.
DRMGetSecurityProvider Ruft den Pfad zu einem Lockbox-Objekt ab.
DRMGetServiceLocation Ruft die URL eines Servers ab, der verschiedene Rechteverwaltungsdienste ausführen kann, z. B. Aktivierung oder Lizenzerwerb.
DRMGetSignedIssuanceLicense Erwirbt eine signierte Ausstellungslizenz online oder offline oder erzeugt eine nicht signierte Ausstellungslizenz, die später signiert werden kann.
DRMGetSignedIssuanceLicenseEx Erwirbt eine signierte Ausstellungslizenz offline.
DRMGetTime Fordert eine sichere Zeit vom Rechteverwaltungssystem an.
DRMGetUnboundLicenseAttribute Ruft ein ungebundenes Lizenz-Attribut aus dem zugrunde liegenden XrML ab.
DRMGetUnboundLicenseAttributeCount Ruft die Anzahl der Vorkommen eines Attributs innerhalb eines Objekts in einer ungebundenen Lizenz ab.
DRMGetUnboundLicenseObject Ruft ein Objekt eines angegebenen Typs in einer ungebundenen Lizenz ab.
DRMGetUnboundLicenseObjectCount Zählt die Instanzen eines Objekts innerhalb einer angegebenen Verzweigung der Lizenz.
DRMGetUsagePolicy Ruft eine Verwendungsrichtlinie ab, die den Zugriff auf Inhalte basierend auf Anwendungsname, Version oder anderen Anwendungsmerkmalen erfordert oder verweigert.
DRMGetUserInfo Ruft Informationen zu einem Benutzer ab.
DRMGetUserRights Ruft Benutzer-/Rechte-Paare aus einer Ausstellungslizenz ab.
DRMGetUsers Ruft einen bestimmten Benutzer aus einer Ausstellungslizenz ab.
DRMInitEnvironment Erstellt eine sichere Umgebung für alle Rechteverwaltungsaufrufe.
DRMIsActivated Gibt an, ob der aktuelle Benutzer oder Computer aktiviert ist.
DRMIsWindowProtected Gibt an, ob ein Fenster einer geschützten Umgebung zugeordnet ist.
DRMLoadLibrary Lädt ein Handle in eine genehmigte Bibliothek, wie durch die Anmeldeinformationen bestimmt.
DRMParseUnboundLicense Erstellt ein Handle zu einer ungebundenen Lizenz, damit eine Anwendung in ihren Objekten und Attributen navigieren kann.
DRMRegisterContent Informiert den Active Directory Rights Management Services (AD RMS)-Client darüber, dass ein AD RMS-geschütztes Dokument ausgeführt wird oder nicht mehr angezeigt wird.
DRMRegisterProtectedWindow Registriert ein Fenster in der geschützten Umgebung.
DRMRegisterRevocationList Registriert eine Rechtesperrliste auf dem Client.
DRMRepair Repariert einen Clientcomputer, indem zertifikate gelöscht werden, die zuvor für den Computer oder Benutzer erstellt wurden.
DRMSetApplicationSpecificData Ermöglicht einer Ausstellungslizenz das Speichern beliebiger Name-Wert-Paare für die Verwendung durch die Inhaltsverwendungsanwendung.
DRMSetGlobalOptions Legt das Transportprotokoll auf einen angegebenen Wert fest und gibt optional an, ob das Server-Lockbox-Objekt verwendet wird.
DRMSetIntervalTime Gibt die Anzahl der Tage ab der Veröffentlichung an, die vor einem Ende übergeben werden kann– Die Benutzerlizenz muss erneuert werden.
DRMSetMetaData Fügt anwendungsspezifische Metadaten zu einer Ausstellungslizenz hinzu.
DRMSetNameAndDescription Ermöglicht einer Anwendung die Angabe von Namen und Beschreibungen der Lizenz in mehreren (menschlichen) Sprachen.
DRMSetRevocationPoint Legt eine Aktualisierungsrate und einen Speicherort fest, um eine Sperrliste abzurufen.
DRMSetUsagePolicy Legt eine Verwendungsrichtlinie fest, die den Zugriff auf Inhalte basierend auf Anwendungsname, Version oder anderen Umgebungsmerkmalen erfordert oder verweigert.
DRMVerify Wird nicht mehr unterstützt und gibt E_NOTIMPL zurück.

Strukturen

DRM_ACTSERV_INFO Die DRM_ACTSERV_INFO Struktur speichert Informationen zum Aktivierungsserver.
DRM_CLIENT_VERSION_INFO Empfängt Informationen über die Version des Active Directory Rights Management Services (AD RMS)-Clients und die Hierarchie, z. B. Produktion oder Vorproduktion.
DRM_LICENSE_ACQ_DATA Enthält Lizenzerwerbsdaten während des nichtsilenten Lizenzerwerbs.
DRMBOUNDLICENSEPARAMS Wird von DRMCreateBoundLicense verwendet, um eine Bindung an eine Lizenz durchzuführen.
DRMID Identifiziert ein Objekt.