Méthode IWMDRMDeviceApp::SynchronizeLicenses

Article
06/13/2023

La méthode SynchronizeLicenses met à jour les licences sur un appareil lorsqu’elles arrivent à expiration.

Syntaxe

HRESULT SynchronizeLicenses(
  [in] IWMDMDevice    *pDevice,
  [in] IWMDMProgress3 *pProgressCallback,
  [in] DWORD          cMinCountThreshold,
  [in] DWORD          cMinHoursThreshold
);

Paramètres

pDevice [in]: Pointeur vers un objet IWMDMDevice .
pProgressCallback [in]: Rappel de progression qui recevra la progression de toutes les étapes qu’il peut avoir besoin d’effectuer. L’étape est identifiée par le paramètre EventId de la méthode IWMDMProgress3 appelée.
cMinCountThreshold [in]: Nombre de lecture minimum restant facultatif sur une licence d’appareil.
cMinHoursThreshold [in]: Heures restantes minimales facultatives sur une licence d’appareil.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK
DRM_E_INVALIDARG	Un ou plusieurs arguments ne sont pas valides.
DRM_E_INVALIDXMLTAG	Xml n’est pas correctement formé.
DRM_E_NOTIMPL	Cette fonctionnalité n’est actuellement pas implémentée. (SyncLicenses avec pDevice =NULL)
DRM_E_NOXMLCLOSETAG	Le code XML de licence n’a pas été correctement formé.
DRM_E_NOXMLOPENTAG	Le code XML de licence n’a pas été correctement formé.
DRM_E_OUTOFMEMORY	Mémoire insuffisante.
DRM_E_XMLNOTFOUND	Impossible de trouver une balise XML requise dans la licence.
NS_E_DEVICE_NOT_WMDRM_DEVICE	L’appareil spécifié n’est pas un appareil compatible avec Windows Media DRM.
NS_E_DRM_NEEDS_INDIVIDUALIZATION	La gestion des droits numériques nécessite une boîte noire individualisée pour effectuer cette fonction. En d’autres termes, le Kit de développement logiciel (SDK) au format Windows Media nécessite une mise à niveau de sécurité.

Notes

Cet appel ne peut être effectué que sur un appareil qui prend en charge Windows Media DRM 10 pour les appareils portables. Vous devez spécifier au moins un paramètre de seuil.

Spécifications

Condition requise	Valeur
En-tête	WMDRMDeviceApp.h (nécessite également Wmdrmdeviceapp_i.c, généré à partir de WMDRMDeviceApp.idl)
Bibliothèque	Mssachlp.lib

Voir aussi

Gestion du contenu protégé dans l’application
IWMDMProgress3 Interface
IWMDRMDeviceApp Interface

Partager via