Sauvegarde et restauration de licences

  • Article

Les processus de sauvegarde et de restauration sont asynchrones. Ils sont déclenchés lorsque l’utilisateur sélectionne une commande de menu ou une option dans l’application pour sauvegarder ou restaurer des licences. Vous devez autoriser l’utilisateur à spécifier les emplacements où les licences doivent être sauvegardées et restaurées.

Pour sauvegarder des licences :

  1. Utilisez la fonction WMCreateBackupRestorer pour créer l’objet de restauration de sauvegarde.
  2. Appelez la méthode IWMBackupRestoreProps::SetProp pour définir le chemin de sauvegarde (l’emplacement où vous allez écrire les fichiers, par exemple A:\ ou D:\Licenses).
  3. Appelez la méthode IWMLicenseBackup::BackupLicenses pour sauvegarder les licences sur le chemin spécifié.

Les événements suivants sont envoyés à la méthode IWMStatusCallback::OnStatus :

  • WMT_BACKUPRESTORE_BEGIN indique que le processus de sauvegarde a démarré.
  • WMT_BACKUPRESTORE_END indique que le processus de sauvegarde est terminé.
  • WMT_RESTRICTED_LICENSE indique qu’une ou plusieurs licences ne peuvent pas être sauvegardées, car le droit a été refusé par le propriétaire du contenu.

L’ID de clé est également inclus dans ce message. Si vous avez implémenté une base de données pour les fichiers protégés qui inclut l’ID de clé et les métadonnées, vous pouvez afficher un message à l’utilisateur avec le titre spécifique (par exemple, un titre de chanson) pour lequel la licence ne peut pas être sauvegardée. Sinon, le message doit être générique et informer l’utilisateur que certaines licences ne peuvent pas être sauvegardées.

Pour restaurer des licences :

  1. Utilisez la fonction WMCreateBackupRestorer pour créer l’objet de restauration de sauvegarde.
  2. Appelez la méthode IWMBackupRestoreProps::SetProp pour définir le chemin de restauration à l’emplacement où les licences sont sauvegardées.
  3. Appelez la méthode IWMLicenseRestore::RestoreLicenses pour restaurer des licences à partir de cet emplacement.

Les événements suivants sont envoyés à la méthode IWMStatusCallback::OnStatus :

  • WMT_BACKUPRESTORE_CONNECTING indique que l’application se connecte au service de gestion des licences.
  • WMT_BACKUPRESTORE_DISCONNECTING indique que l’application se déconnecte du service de gestion des licences.
  • WMT_BACKUPRESTORE_BEGIN indique que le processus de restauration a démarré.
  • WMT_BACKUPRESTORE_END indique que le processus de restauration est terminé.

Notes

La gestion des droits numériques n’est pas prise en charge par la version x64 de ce Kit de développement logiciel (SDK).

 

Fonctionnalités de gestion des droits numériques

IWMBackupRestoreProps, interface

IWMLicenseBackup, interface

IWMLicenseRestore Interface