Partager via


Méthode IWMDRMSecurity::P erformSecurityUpdate

[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.]

La méthode PerformSecurityUpdate lance une mise à jour de sécurité du sous-système DRM sur l’ordinateur local.

Syntaxe

HRESULT PerformSecurityUpdate(
  [in]  DWORD    dwFlags,
  [out] IUnknown **ppunkCancelationCookie
);

Paramètres

dwFlags [in]

Option de mise à jour exprimée sous la forme d’un des indicateurs suivants.

Indicateur Description
WMDRM_SECURITY_PERFORM_INDIV Entraîne l’individualisation du composant DRM uniquement si la version du client est obsolète.
WMDRM_SECURITY_PERFORM_REVOCATION_REFRESH Provoque la mise à jour des listes de révocation sur l’ordinateur client.
WMDRM_SECURITY_PERFORM_FORCE_INDIV Entraîne l’individualisation du composant DRM même si la version du client est à jour.

ppunkCancelationCookie [out]

Adresse d’une variable qui reçoit un pointeur vers un objet qui peut être utilisé pour annuler cette opération.

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

Notes

Cette méthode s’exécute de manière asynchrone. Il retourne immédiatement après avoir été appelé, puis génère des événements en fonction de l’indicateur défini dans le paramètre dwFlags .

Pour l’individualisation (indicateur défini sur WMDRM_SECURITY_PERFORM_INDIV ou WMDRM_SECURITY_PERFORM_FORCE_INDIV), une série d’événements MEWMDRMIndividualizationProgress est générée, suivie d’un événement MEWMDRMIndividualizationCompleted lorsque le traitement est terminé. La valeur de chacun des événements MEWMDRMIndividualizationProgress obtenus en appelant IMFMediaEvent::GetValue est un pointeur IUnknown . Vous pouvez appeler la méthode QueryInterface de l’interface IUnknown récupérée pour obtenir une instance de l’interface IWMDRMIndividualizationStatus.

Pour l’actualisation des listes de révocation (indicateur défini sur WMDRM_SECURITY_PERFORM_REVOCATION_REFRESH), un événement MEWMDRMREvocationDownloadCompleted est généré une fois le traitement terminé.

Notes

Lorsque PerformSecurityUpdate termine l’individualisation, les seuls objets existants qui reflètent le nouvel état individualisé sont ceux qui héritent d’IWMDRMSecurity. Tous les autres objets existants ne seront pas mis à jour. Vous devez libérer et recréer tous les autres objets afin qu’ils reflètent le nouvel état individualisé.

Pour plus d’informations sur l’utilisation des méthodes asynchrones des API étendues du client Windows Media DRM, consultez Utilisation du modèle d’événement Media Foundation.

Configuration requise

Condition requise Valeur
En-tête
Wmdrmsdk.h
Bibliothèque
Wmdrmsdk.lib

Voir aussi

Révocation et renouvellement automatisés de composants

Exemple d’individualisation DRM

IWMDRMSecurity Interface

Exécution de l’individualisation DRM