Méthode IWMDRMDeviceApp2::QueryDeviceStatus2

Article
06/13/2023

La méthode QueryDeviceStatus2 interroge un appareil pour une status ou une fonctionnalité DRM spécifique.

Syntaxe

HRESULT QueryDeviceStatus2(
  [in]  IWMDMDevice *pDevice,
  [in]  DWORD       dwFlags,
  [out] DWORD       *pdwStatus
);

Paramètres

pDevice [in]

Pointeur vers un objet IWMDMDevice .

dwFlags [in]

Une ou plusieurs des valeurs DWORD suivantes spécifiant les fonctionnalités à demander, combinées à un OR au niveau du bit.

Indicateur	Description
WMDRM_QUERY_CLIENT_INDIVSTATUS	Interrogez si les composants DRM de l’ordinateur doivent être individualisés.
WMDRM_QUERY_DEVICE_CLOCKSTATUS	Vérifiez si l’horloge sécurisée de l’appareil doit être ajoutée ou mise à jour.
WMDRM_QUERY_DEVICE_ISREVOKED	Interrogez si l’appareil est révoqué.
WMDRM_QUERY_DEVICE_ISWMDRM	Vérifiez si l’appareil prend en charge Windows Media DRM 10 pour les appareils portables.

pdwStatus [out]

Zéro ou plusieurs des valeurs DWORD suivantes spécifiant le status d’appareil demandé, combinées à un OR au niveau du bit.

Statut	Description
WMDRM_DEVICE_ISWMDRM	L’appareil prend en charge Windows Media DRM.
WMDRM_DEVICE_NEEDCLOCK	L’appareil n’a pas d’horloge sécurisée.
WMDRM_DEVICE_REVOKED	L’appareil a été révoqué.
WMDRM_CLIENT_NEEDINDIV	Les composants DRM de l’ordinateur doivent être individualisés.
WMDRM_DEVICE_REFRESHCLOCK	L’horloge doit être actualisée.

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
DRM_E_INVALIDARG	Un ou plusieurs arguments ne sont pas valides.
NS_E_DRM_INVALID_CERTIFICATE	Le certificat d’appareil récupéré à partir de l’appareil n’est pas valide.
NS_E_DRM_UNABLE_TO_GET_DEVICE_CERT	Échec de la récupération du certificat d’appareil à partir de l’appareil.

Notes

Cette méthode doit être appelée avant d’effectuer des actions restreintes sur le contenu DRM, telles que le transfert de contenu DRM vers l’appareil ou l’acquisition d’informations de contrôle. Si les valeurs récupérées par pdwStatus indiquent qu’une action doit être effectuée (par exemple, l’individualisation du bureau ou l’acquisition d’une horloge pour l’appareil), l’application doit appeler IWMDRMDeviceApp::AcquireDeviceData et passer la valeur pdwStatus récupérée de cette fonction au paramètre dwFlags dans AcquireDeviceData. Si zéro est retourné, l’appareil ne prend pas en charge Windows Media DRM 10 pour les appareils portables et aucune action n’est nécessaire. Pour plus d’informations, consultez Gestion du contenu protégé dans l’application .

Spécifications

Condition requise	Valeur
En-tête	WMDRMDeviceApp.h (nécessite également Wmdrmdeviceapp_i.c, généré à partir de WMDRMDeviceApp.idl)
Bibliothèque	Mssachlp.lib

Voir aussi

Gestion du contenu protégé dans l’application
IWMDRMDeviceApp::QueryDeviceStatus
IWMDRMDeviceApp2 Interface

Partager via