Partager via


Énumération des licences dans le magasin de licences local

[La fonctionnalité associée à cette page, le Kit de développement logiciel (SDK) Windows Media Format 11, est une fonctionnalité héritée. Il a été remplacé par lecteur source et enregistreur récepteur. Le lecteur source et l’enregistreur récepteur ont été optimisés pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise le lecteur source et l’enregistreur récepteur au lieu du Kit de développement logiciel (SDK) Windows Media Format 11, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

L’énumération est un processus d’obtention d’informations sur les licences dans le magasin de licences local, en les parcourant une par une. Vous pouvez créer une énumération de licence en appelant IWMDRMLicenseManagement::CreateLicenseEnumeration.

La raison la plus courante de l’énumération par le biais de licences dans le magasin est de trouver une licence particulière pour le déchiffrement de certains contenus.

L’interface IWMDRMLicense sert à la fois de portail vers les résultats de licence individuels et d’énumérateur. Lorsque l’énumération de licence est créée, la première licence de la liste est chargée dans l’interface IWMDRMLicense . La plupart des méthodes d’IWMDRMLicense vous permettent d’obtenir des informations sur la licence ou de créer des objets pour chiffrer ou déchiffrer le contenu en fonction de la licence. Toutefois, il existe deux méthodes qui contrôlent l’énumération : GetNext et ResetEnumeration. GetNext charge la licence suivante dans la liste dans l’interface. ResetEnumeration retourne l’énumération à l’état dans lequel elle se trouvait lors de sa première création. Lorsque l’énumération est réinitialisée, la première licence de la liste est de nouveau chargée dans l’interface IWMDRMLicense .

Lorsque vous avez atteint la dernière licence de la liste, l’appel suivant à GetNext retourne ERROR_NO_MORE_ITEMS.

Si votre application effectue une action avec le contenu couvert par drm, vous devez case activée les licences dans le magasin de licences local pour les droits et pour d’autres facteurs limitatifs, tels que les niveaux de protection de sortie (OPL).

Obtention d’informations à partir de licences dans le magasin de licences local