IWMDRMDeviceApp :: AcquireDeviceData, méthode

La méthode AcquireDeviceData Initialise ou réinitialise une horloge sécurisée d’appareil.

Syntaxe

HRESULT AcquireDeviceData(
  [in]  IWMDMDevice    *pDevice,
  [in]  IWMDMProgress3 *pProgressCallback,
  [in]  DWORD          dwFlags,
  [out] DWORD          *pdwStatus
);

Paramètres

pDevice [ dans]

Pointeur vers une interface IWMDMDevice pour l’appareil qui signale les données de contrôle.

pProgressCallback [ dans]

Rappel de progression via lequel l’application peut suivre la progression de l’événement ou annuler l’événement. La progression est identifiée par le paramètre eventID des méthodes IWMDMProgress3 .

dwFlags [ dans]

Or logique de l’un des indicateurs suivants, en spécifiant l’action à effectuer. Cette valeur est extraite du paramètre pdwStatus de IWMDRMDeviceApp :: QueryDeviceStatus ou IWMDRMDeviceApp2 :: QueryDeviceStatus2. Vous pouvez utiliser l’indicateur pdwStatus directement.

Indicateur Description
_NEEDCLOCK d’appareil WMDRM _ Acquérir une horloge à partir d’un serveur d’horloge sécurisé.
_REFRESHCLOCK d’appareil WMDRM _ Actualisez l’horloge à partir d’un serveur d’horloge sécurisé.

pdwStatus [ à]

Une des valeurs DWORD suivantes spécifiant l’état retourné par l’appareil.

État Description
0 L’action n’est pas prise en charge.
1 L’horloge sécurisée de l’appareil n’a pas pu être acquise auprès du service.
2 L’horloge sécurisée de l’appareil n’a pas pu être définie.
3 L’horloge sécurisée de l’appareil a été définie.

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.
appareil _ NS _ E _ non _ WMDRM _
l’appareil spécifié n’est pas un appareil compatible avec DRM Windows Media.
la _ _ protection d’accès du service d’E/DRM _ ne peut pas _ obtenir un _ _ _ réveil sécurisé
Impossible de récupérer le challenge d’horloge sécurisée à partir de l’appareil ou de récupérer l’URL d’horloge sécurisée à partir de la demande.
NS _ E _ DRM _ ne peut pas _ _ obtenir une _ horloge sécurisée _ _ à partir du _ serveur
Échec de la récupération de la réponse d’horloge sécurisée à partir du serveur d’horloge sécurisé.
NS _ E _ DRM _ ne peut pas _ _ définir l' _ horloge sécurisée _
Impossible d’envoyer le challenge d’horloge sécurisée à l’appareil, ou l’appareil n’a pas pu définir l’horloge.

Remarques

Il s’agit d’une méthode asynchrone ; l’appareil doit attendre le rappel IWMDMProgress :: end pour cette opération avant de tenter de lire un contenu sous licence.

Une application peut déterminer si l’horloge de l’appareil doit être réinitialisée ou mise à jour en appelant IWMDRMDeviceApp :: QueryDeviceStatus ou IWMDRMDeviceApp2 :: QueryDeviceStatus2.

Votre application doit disposer d’une connexion Internet pour lui permettre d’acquérir ou de réinitialiser une horloge sécurisée.

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

Interface IWMDMDevice

Interface IWMDMProgress3

Interface IWMDRMDeviceApp