Lire en anglais

Partager via


Active Directory Rights Management Services SDK

Vue d’ensemble de la technologie sdk Active Directory Rights Management Services.

Pour développer le Kit de développement logiciel (SDK) Active Directory Rights Management Services, vous avez besoin des en-têtes suivants :

Pour obtenir des conseils de programmation pour cette technologie, consultez :

Énumérations

 
DRM_DISTRIBUTION_POINT_INFO

Spécifie le type de point de distribution à récupérer des informations sur l’appel de DRMGetIssuanceLicenseInfo.
DRM_STATUS_MSG

Utilisé par la fonction de rappel personnalisée pour spécifier la raison pour laquelle la fonction de rappel est appelée.
DRM_USAGEPOLICY_TYPE

Utilisé avec les fonctions DRMGetUsagePolicy et DRMSetUsagePolicy pour spécifier un type de stratégie d’utilisation.
DRMATTESTTYPE

L’énumération DRMATTESTTYPE spécifie le type de signature à créer pour un objet blob de données.
DRMENCODINGTYPE

L’énumération DRMENCODINGTYPE identifie les types d’encodage possibles utilisés dans les licences.
DRMGLOBALOPTIONS

Définit des valeurs pour spécifier quel protocole est utilisé pour le protocole de transport et si la zone de verrouillage du serveur est utilisée. Cette énumération est utilisée par la fonction DRMSetGlobalOptions.
DRMSECURITYPROVIDERTYPE

L’énumération DRMSECURITYPROVIDERTYPE spécifie le type d’environnement DRM sécurisé utilisé.
DRMSPECTYPE

L’énumération DRMSPECTYPE indique le type de fournisseur de bibliothèque ou de sécurité utilisé.
DRMTIMETYPE

L’énumération DRMTIMETYPE spécifie un type de temps.

Fonctions

 
DRMAcquireAdvisories

Récupère les listes de révocation requises par une licence soumise.
DRMAcquireIssuanceLicenseTemplate

Récupère de manière asynchrone des modèles de licence d’émission à partir d’un serveur.
DRMAcquireLicense

Tente d’acquérir une licence d’utilisateur final ou un certificat de licence client de manière asynchrone.
DRMActivate

Obtient un certificat lockbox et un certificat d’ordinateur pour une machine ou un certificat de compte de droits pour un utilisateur.
DRMAddLicense

Ajoute une licence d’utilisateur final au magasin de licences temporaire ou permanent.
DRMAddRightWithUser

Attribue un droit à un utilisateur dans une licence d’émission.
DRMAttest

La fonction DRMAttest n’est plus prise en charge et retourne E_NOTIMPL.
DRMCALLBACK

Certaines des fonctions incluses dans le Kit de développement logiciel (SDK) AD RMS fournissent des informations et des licences status à votre application à l’aide d’une fonction de rappel que vous devez implémenter. La syntaxe de rappel est illustrée ci-dessous.
DRMCheckSecurity

Retourne S_OK pour n’importe quel niveau du case activée de sécurité en cours d’exécution.
DRMClearAllRights

Supprime tous les droits d’une licence d’émission existante.
DRMCloseEnvironmentHandle

Ferme un handle d’environnement.
DRMCloseHandle

Ferme les handles aux objets créés avec les fonctions et bibliothèques DRMCreate* chargées à l’aide de DRMLoadLibrary.
DRMClosePubHandle

Ferme un DRMPUBHANDLE créé précédemment.
DRMCloseQueryHandle

Ferme un handle à un objet de licence non lié.
DRMCloseSession

Ferme une session cliente ou une session de stockage de licences.
DRMConstructCertificateChain

Génère une chaîne de certificats à partir d’un nombre arbitraire de certificats.
DRMCreateBoundLicense

Permet à une application d’examiner ou d’exercer les droits sur une licence stockée localement.
DRMCreateClientSession

Crée une session cliente, qui héberge des sessions de stockage de licences et est utilisée dans l’activation et d’autres appels de fonction.
DRMCreateEnablingBitsDecryptor

Crée un objet de déchiffrement utilisé pour déchiffrer les données de contenu.
DRMCreateEnablingBitsEncryptor

Crée un objet de chiffrement AD RMS utilisé pour chiffrer les données de contenu.
DRMCreateEnablingPrincipal

Crée un principal d’activation nécessaire pour la liaison à une licence.
DRMCreateIssuanceLicense

Crée une licence d’émission à partir de zéro, d’un modèle ou d’une licence d’émission signée.
DRMCreateLicenseStorageSession

Crée une session de stockage de licence, qui est nécessaire pour acquérir ou manipuler une licence.
DRMCreateRight

Crée un droit XrML qui définit un droit accordé à un utilisateur ou à un groupe.
DRMCreateUser

Crée un utilisateur qui recevra un droit.
DRMDecode

Décode une chaîne encodée avec un algorithme commun, tel que base64.
DRMDeconstructCertificateChain

Récupère un certificat spécifié à partir d’une chaîne de certificats.
DRMDecrypt

Déchiffre le contenu chiffré.
DRMDeleteLicense

Supprime une licence, un certificat de licence client, une liste de révocation ou un modèle de licence d’émission.
DRMDuplicateEnvironmentHandle

Crée une copie d’un handle d’environnement.
DRMDuplicateHandle

Crée une copie d’un DRMHANDLE.
DRMDuplicatePubHandle

Effectue une copie d’un DRMPUBHANDLE.
DRMDuplicateSession

Dupliquer une session de stockage client ou de licence.
DRMEncode

Encode les données à l’aide d’une méthode d’encodage publique, telle que base64.
DRMEncrypt

Chiffre les données.
DRMEnumerateLicense

Énumère des licences valides, des certificats d’ordinateur ou des certificats de compte de droits, des listes de révocation pour l’utilisateur actuel ou des modèles de licence d’émission.
DRMGetApplicationSpecificData

Récupère une paire nom-valeur d’informations arbitraires spécifiques à l’application.
DRMGetBoundLicenseAttribute

Récupère un attribut de licence lié à partir de la licence XrML.
DRMGetBoundLicenseAttributeCount

Récupère le nombre d’occurrences d’un attribut dans une licence.
DRMGetBoundLicenseObject

Retourne un objet à partir d’une licence liée.
DRMGetBoundLicenseObjectCount

Récupère le nombre d’occurrences d’un objet dans une branche spécifiée d’une licence.
DRMGetCertificateChainCount

Récupère le nombre de certificats dans une chaîne de certificats.
DRMGetClientVersion

Retourne le numéro de version du logiciel client Active Directory Rights Management Services et indique si la hiérarchie est à des fins de production ou de préproduction.
DRMGetEnvironmentInfo

Retourne des informations sur un environnement sécurisé.
DRMGetInfo

Récupère des informations sur le chiffrement ou le déchiffrement d’objets.
DRMGetIntervalTime

Récupère le nombre de jours à partir de l’émission qui peuvent passer avant qu’une licence d’utilisateur final ne soit renouvelée.
DRMGetIssuanceLicenseInfo

Récupère diverses informations à partir d’une licence d’émission.
DRMGetIssuanceLicenseTemplate

Obtient un modèle de licence d’émission à partir d’une licence d’émission existante.
DRMGetMetaData

Récupère les métadonnées d’une licence d’émission.
DRMGetNameAndDescription

Récupère un nom et une description spécifiques à une langue à partir d’une licence d’émission.
DRMGetOwnerLicense

Récupère une licence de propriétaire créée en appelant DRMGetSignedIssuanceLicense.
DRMGetProcAddress

Retourne l’adresse d’une fonction dans une bibliothèque. Il s’agit de la version sécurisée de la fonction GetProcAddress.
DRMGetRevocationPoint

Récupère des informations sur le point de révocation d’une licence d’émission.
DRMGetRightExtendedInfo

Récupère les paires nom-valeur personnalisées attachées à un droit.
DRMGetRightInfo

Obtient des informations sur un droit créé précédemment.
DRMGetSecurityProvider

Récupère le chemin d’accès à une zone de verrouillage.
DRMGetServiceLocation

Récupère l’URL d’un serveur qui peut effectuer différents services de gestion des droits, tels que l’activation ou l’acquisition de licences.
DRMGetSignedIssuanceLicense

Acquiert une licence d’émission signée en ligne ou hors connexion, ou produit une licence d’émission non signée qui peut être signée ultérieurement.
DRMGetSignedIssuanceLicenseEx

Acquiert une licence d’émission signée hors connexion.
DRMGetTime

Demande une heure sécurisée à partir du système de gestion des droits.
DRMGetUnboundLicenseAttribute

Récupère un attribut de licence non lié à partir du XrML sous-jacent.
DRMGetUnboundLicenseAttributeCount

Récupère le nombre d’occurrences d’un attribut dans un objet dans une licence non lié.
DRMGetUnboundLicenseObject

Récupère un objet d’un type spécifié dans une licence non lié.
DRMGetUnboundLicenseObjectCount

Compte les instances d’un objet dans une branche spécifiée de la licence.
DRMGetUsagePolicy

Obtient une stratégie d’utilisation qui nécessite ou refuse l’accès au contenu en fonction du nom de l’application, de la version ou d’autres caractéristiques de l’application.
DRMGetUserInfo

Obtient des informations sur un utilisateur.
DRMGetUserRights

Récupère les paires utilisateur/droit à partir d’une licence d’émission.
DRMGetUsers

Récupère un utilisateur spécifique à partir d’une licence d’émission.
DRMInitEnvironment

Crée un environnement sécurisé pour tous les appels de gestion des droits.
DRMIsActivated

Indique si l’utilisateur ou l’ordinateur actuel est activé.
DRMIsWindowProtected

Indique si une fenêtre est associée à un environnement protégé.
DRMLoadLibrary

Charge un handle dans une bibliothèque approuvée, comme déterminé par les informations d’identification.
DRMParseUnboundLicense

Crée un handle pour une licence non lié pour permettre à une application de naviguer dans ses objets et attributs.
DRMRegisterContent

Informe le client AD RMS (Active Directory Rights Management Services) qu’un document protégé par AD RMS est ou n’est plus affiché.
DRMRegisterProtectedWindow

Inscrit une fenêtre dans l’environnement protégé.
DRMRegisterRevocationList

Inscrit une liste de révocation de droits sur le client.
DRMRepair

Répare un ordinateur client en supprimant les certificats créés précédemment pour l’ordinateur ou l’utilisateur.
DRMSetApplicationSpecificData

Permet à une licence d’émission de stocker des paires nom-valeur arbitraires à utiliser par l’application consommatrice de contenu.
DRMSetGlobalOptions

Définit le protocole de transport sur une valeur spécifiée et spécifie éventuellement si la zone de verrouillage du serveur est utilisée.
DRMSetIntervalTime

Spécifie le nombre de jours à partir de l’émission qui peuvent passer avant qu’une licence d’utilisateur final ne soit renouvelée.
DRMSetMetaData

Ajoute des métadonnées spécifiques à l’application à une licence d’émission.
DRMSetNameAndDescription

Permet à une application de spécifier des noms et des descriptions de la licence dans plusieurs langues (humaines).
DRMSetRevocationPoint

Définit un taux d’actualisation et un emplacement pour obtenir une liste de révocation.
DRMSetUsagePolicy

Définit une stratégie d’utilisation qui nécessite ou refuse l’accès au contenu en fonction du nom de l’application, de la version ou d’autres caractéristiques de l’environnement.
DRMVerify

N’est plus pris en charge et retourne E_NOTIMPL.

Structures

 
DRM_ACTSERV_INFO

La structure DRM_ACTSERV_INFO stocke des informations sur le serveur d’activation.
DRM_CLIENT_VERSION_INFO

Reçoit des informations sur la version du client AD RMS (Active Directory Rights Management Services) et la hiérarchie, telles que production ou préproduction.
DRM_LICENSE_ACQ_DATA

Contient les données d’acquisition de licence lors de l’acquisition de licences nonilentes.
DRMBOUNDLICENSEPARAMS

Utilisé par DRMCreateBoundLicense pour se lier à une licence.
DRMID

Identifie un objet.