DRMAcquire Advisories, fonction (msdrm.h)
[Kit de développement logiciel (SDK) AD RMS tirant parti des fonctionnalités exposées par
le client dans Msdrm.dll est disponible pour une utilisation dans Windows Server 2008, Windows Vista, Windows Server 2008 R2, Windows 7, Windows Server 2012 et Windows 8. Il peut être modifié ou
indisponible dans les versions suivantes. Utilisez plutôt Kit de développement logiciel (SDK) Active Directory Rights Management Services 2.1,
qui tire parti des fonctionnalités exposées par le client dans Msipc.dll.]
La fonction DRMAcquire Advisories récupère les listes de révocation requises par une licence soumise. Les listes de révocation récupérées sont ajoutées au magasin de licences permanent de l’utilisateur. Une liste de révocation est un document XrML signé qui spécifie les principaux qui ont été révoqués, car ils ne sont plus considérés comme dignes de confiance ou valides. Ces principaux peuvent inclure des certificats de compte de droits , des certificats d’ordinateur , des certificats de signature de code, des manifestes et des certificats de licence serveur, entre autres.
Syntaxe
DRMEXPORT HRESULT UDAPICALL DRMAcquireAdvisories(
[in] DRMHSESSION hLicenseStorage,
[in] PWSTR wszLicense,
[in, optional] PWSTR wszURL,
[in] VOID *pvContext
);
Paramètres
[in] hLicenseStorage
Handle vers une session de stockage de licence créée à l’aide de la fonction DRMCreateLicenseStorageSession
[in] wszLicense
Pointeur vers une chaîne Unicode terminée par null qui contient la licence qui nécessite une liste de révocation. Il peut s’agir de n’importe quelle licence ou certificat (ou chaîne de certificats ou licences concaténées) qui prend en charge les listes de révocation, y compris licences d’utilisateur final, certificats de compte de droitsou certificats de licence client.
[in, optional] wszURL
Pointeur vers une chaîne Unicode terminée par null qui contient une URL supplémentaire pour rechercher des avis. Cela sera vérifié en plus des URL mentionnées dans la licence transmise. Ce paramètre peut être défini sur NULL .
[in] pvContext
Valeur définie par l’application 32 bits envoyée dans le paramètre pvContext de la fonction de rappel. Cette valeur peut être un pointeur vers des données, un pointeur vers un handle d’événement ou tout autre élément de la fonction de rappel personnalisée est conçue pour gérer. Pour plus d’informations, consultez prototype de rappel.
Valeur de retour
Si la fonction réussit, la fonction retourne S_OK.
Si la fonction échoue, elle retourne une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.
Remarques
Cette fonction récupère les listes de conseils de manière asynchrone. L’URL dans laquelle la liste de révocation est publiée est stockée dans la licence transmise, mais elle peut être remplacée par wszURL.
Une fois qu’une liste de conseils a été obtenue, elle doit être inscrite à l’aide de DRMRegisterRevocationList. Il est plus simple d’énumérer toutes les licences dans le magasin de licences à l’aide de DRMEnumerateLicense, puis d’inscrire chacune d’elles, plutôt que de tenter de localiser l’élément que vous venez d’acquérir.
Vous devez supprimer régulièrement des listes de révocation dupliquées ou obsolètes du magasin de licences en énumérant des listes de révocation. Pour énumérer les listes de révocation, appelez DRMEnumerateLicense avec l’indicateur DRM_EL_EXPIRED, puis appelez DRMDeleteLicense. Étant donné que l’énumération et l’examen des licences peuvent prendre du temps, une application peut effectuer cette tâche uniquement régulièrement.
Une application est informée qu’une nouvelle liste de révocation doit être acquise si l’appel à la fonction DRMCreateBoundLic ense retourne E_DRM_BIND_REVOCATION_LIST_STALE ou E_DRM_BIND_NO_APPLICABLE_REVOCATION_LIST.
Pour plus d’informations sur les listes de révocation et leur création, consultez le guide de déploiement des services Rights Management Active Directory, fourni avec Rights Management Services.
La fonction de rappel d’application spécifiée dans la fonction DRMCreateClientSession sera appelée avec le message DRM_MSG_ACQUIRE_ADVISORY pour fournir des commentaires d’état.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Windows |
| d’en-tête | msdrm.h |
| bibliothèque | Msdrm.lib |
| DLL | Msdrm.dll |
Voir aussi
révoquer un de certificat