Méthode IWMDRMSecurity::GetMachineCertificate

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 GetMachineCertificate récupère le certificat d’ordinateur du sous-système DRM sur l’ordinateur client.

Syntaxe

HRESULT GetMachineCertificate(
  [in]      DWORD dwCertificateType,
  [out]     BYTE  rgbVersion[4],
  [out]     BYTE  **ppbCertificate,
  [in, out] DWORD *pcbCertificate
);

Paramètres

dwCertificateType [in]

Type de certificat à récupérer. Définissez sur l’une des valeurs du tableau suivant.

Valeur	Description
WMDRM_CERTIFICATE_TYPE_V1	Le certificat sera récupéré au format utilisé par les composants hérités.
WMDRM_CERTIFICATE_TYPE_V2	Le certificat sera récupéré au format utilisé par les composants Windows Vista.

rgbVersion[4] [out]

Tableau de quatre octets spécifiant la version du sous-système DRM sur l’ordinateur client.

ppbCertificate [out]

Adresse d’une variable qui reçoit un pointeur vers les données de certificat. Définissez la valeur NULL pour que la méthode fournisse la taille de mémoire tampon requise pour contenir le certificat dans pcbCertificate.

pcbCertificate [in, out]

Taille du certificat en octets. Si ppbCertificate a la valeur NULL, cette valeur est définie sur la taille du certificat. Si ppbCertificate n’a pas la valeur NULL, cette valeur doit être définie sur la taille de la mémoire tampon.

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

Configuration requise

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

Voir aussi

IWMDRMSecurity Interface