Méthode IWMDRMSecurity::GetContentEnablersForRevocations

Article
06/21/2023

[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 GetContentEnablersForRevocations récupère les interfaces d’activation de contenu qui permettent le renouvellement des composants en fonction des certificats révoqués.

Syntaxe

HRESULT GetContentEnablersForRevocations(
  [in]      BYTE              **rgpbCerts,
  [in]      DWORD             *rgpdwCertSizes,
  [in]      GUID              **rgpguidCerts,
  [in]      DWORD             cCerts,
  [in]      HRESULT           hResultHint,
  [out]     IMFContentEnabler **prgContentEnablers,
  [in, out] DWORD             *pcContentEnablers
);

Paramètres

rgpbCerts [in]

Tableau de certificats pour lequel récupérer des activations de contenu. Le nombre d’éléments dans le tableau doit être spécifié par cCerts.

rgpdwCertSizes [in]

Tableau contenant les tailles des certificats dans le tableau rgpbCerts . Le nombre d’éléments dans le tableau doit être spécifié par cCerts.

rgpguidCerts [in]

Tableau contenant les types des certificats dans le tableau rgpbCerts . Le nombre d’éléments dans le tableau doit être spécifié par cCerts. Pour chaque élément du tableau, utilisez l’une des valeurs suivantes.

Constante GUID	Description
WMDRM_REVOCATIONTYPE_APP	Spécifie un certificat d’application.
WMDRM_REVOCATIONTYPE_DEVICE	Spécifie un certificat d’appareil.
WMDRM_REVOCATIONTYPE_CARDEA	Spécifie un certificat Drm Windows Media pour les appareils réseau.

cCerts [in]

Nombre de certificats pour 2000 pour 1000. Il s’agit du nombre d’éléments dans le tableau rgpbCerts , le tableau rgpdwCertSizes et le tableau rgpguidCerts .

hResultHint [in]

Valeur de retour reçue de l’opération qui a échoué en raison d’un certificat révoqué. Si vous n’appelez pas en réponse à un appel de méthode ayant échoué, définissez sur S_OK.

prgContentEnablers [out]

Tableau qui reçoit les adresses des interfaces IMFContentEnabler nouvellement créées . Définissez la valeur NULL pour obtenir le nombre d’activations de contenu dans le paramètre pcContentEnablers .

pcContentEnablers [in, out]

Nombre d’éléments dans le tableau prgContentEnablers . Si prgContentEnablers a la valeur NULL, cette valeur est définie sur le nombre d’enablers de contenu nécessaires sur la sortie.

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

Si vous utilisez l’interface IMFContentEnabler pour renouveler les composants révoqués, vous devez clarifier le processus pour l’utilisateur. Cette clarification doit être apportée, car le processus de mise à jour envoie des informations de l’ordinateur client à un site Web Microsoft.

Lorsque vous appelez IMFContentEnabler::AutomaticEnable, l’enabler de contenu lance le navigateur par défaut avec l’adresse du service de mise à jour sur le site Web de Microsoft. Un identificateur unique qui identifie le composant révoqué est envoyé au service de mise à jour. Le service redirige ensuite le navigateur vers une page web à partir de laquelle l’utilisateur peut télécharger et installer la nouvelle version du composant révoqué.

Configuration requise

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

Voir aussi

Révocation et renouvellement automatisés de composants
IWMDRMSecurity Interface

Partager via