Méthode IWMDRMLicense::CreateSecureDecryptor

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 CreateSecureDecryptor crée un objet de déchiffreur sécurisé. Le déchiffreur sécurisé diffère du déchiffreur normal en ce qu’il déchiffre le contenu, puis le rechiffre en fonction des paramètres spécifiés dans les paramètres de cette méthode.

Syntaxe

HRESULT CreateSecureDecryptor(
  [in]      BYTE          *pbCertificate,
  [in]      DWORD         cbCertificate,
  [in]      DWORD         dwCertificateType,
  [in]      DWORD         dwFlags,
  [out]     BYTE          *pbInitializationVector,
  [in, out] DWORD         *pcbInitializationVector,
  [out]     IWMDRMDecrypt **ppDecryptor
);

Paramètres

pbCertificate [in]

Certificat de l’application appelante.

cbCertificate [in]

Taille du certificat en octets.

dwCertificateType [in]

Type du certificat. Définissez sur WMDRM_CERTIFICATE_TYPE_XML.

dwFlags [in]

Type de protection de session à utiliser pour le récodage. Doit être défini sur l’une des constantes du tableau suivant :

Constant	Description
WMDRM_PROTECTION_TYPE_RC4	Utilise le chiffrement RC4 pour le chiffrement de session. Il s’agit de la seule protection de session prise en charge pour cette version.

pbInitializationVector [out]

Reçoit le vecteur d’initialisation. Le vecteur d’initialisation est chiffré RSA à l’aide du schéma de remplissage OAEP avec la clé publique RSA trouvée dans le certificat. Définissez sur NULL pour recevoir la taille de mémoire tampon requise dans pcbInitializationVector.

pcbInitializationVector [in, out]

En entrée, la taille de la mémoire tampon passée en tant que pbInitializationVector. En sortie, la taille de la partie utilisée de la mémoire tampon. Si vous passez null pour pbInitializationVector, cette valeur est définie sur la taille de mémoire tampon requise sur la sortie.

ppDecryptor [out]

Reçoit un pointeur vers l’interface IWMDRMDecrypt de l’objet nouvellement créé.

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

Aucun.

Configuration requise

Condition requise	Valeur
En-tête	Wmdrmsdk.h

Voir aussi

IWMDRMLicense, interface

Partager via