IWMDRMDeviceApp2 :: QueryDeviceStatus2, méthode

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

Syntaxe

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

Paramètres

pDevice [ dans]

Pointeur vers un objet IWMDMDevice .

dwFlags [ dans]

Une ou plusieurs des valeurs DWORD suivantes spécifiant les fonctionnalités à demander, combinées avec une opération or au niveau du bit.

Indicateur Description
_INDIVSTATUS du _ client de requête WMDRM _ Demander si les composants DRM de l’ordinateur doivent être individualisés.
CLOCKSTATUS de l' _ appareil de requête WMDRM _ _ Demander si l’horloge sécurisée de l’appareil doit être ajoutée ou mise à jour.
ISREVOKED de l' _ appareil de requête WMDRM _ _ Demander si l’appareil est révoqué.
ISWMDRM de l' _ appareil de requête WMDRM _ _ demander si l’appareil prend en charge Windows Media DRM 10 pour les appareils mobiles.

pdwStatus [ à]

Zéro, une ou plusieurs des valeurs DWORD suivantes spécifiant l’état de l’appareil demandé, combiné avec une opération or au niveau du bit.

Statut Description
_ISWMDRM d’appareil WMDRM _ l’appareil prend en charge Windows DRM Media.
_NEEDCLOCK d’appareil WMDRM _ L’appareil n’a pas d’horloge sécurisée.
_appareil WMDRM _ révoqué L’appareil a été révoqué.
_NEEDINDIV du client WMDRM _ Les composants DRM de l’ordinateur doivent être individualisés.
_REFRESHCLOCK d’appareil WMDRM _ 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
_OK
S_OK
DRM _ E _ INVALIDARG
Un ou plusieurs arguments ne sont pas valides.
_ _ _ certificat non valide NS E DRM _
Le certificat d’appareil récupéré à partir de l’appareil n’est pas valide.
NS _ E _ DRM- _ Impossible _ d' _ accéder au _ _ certificat de l’appareil
Impossible de récupérer le certificat de l’appareil à partir de l’appareil.

Remarques

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

Configuration requise

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

Voir aussi

Gestion du contenu protégé dans l’application

IWMDRMDeviceApp::QueryDeviceStatus

Interface IWMDRMDeviceApp2