IWMDRMDeviceApp::AcquireDeviceData-Methode

Artikel
06/13/2023

Die AcquireDeviceData-Methode initialisiert oder setzt eine sichere Uhr des Geräts zurück.

Syntax

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

Parameter

pDevice [in]

Zeiger auf eine IWMDMDevice-Schnittstelle für das Gerät, das Messdaten meldet.

pProgressCallback [in]

Statusrückruf, über den die Anwendung den Fortschritt des Ereignisses nachverfolgen oder das Ereignis abbrechen kann. Der Fortschritt wird durch den EventId-Parameter der IWMDMProgress3-Methoden identifiziert.

dwFlags [in]

Ein logischer OR mit einem oder beiden der folgenden Flags, der angibt, welche Aktion ausgeführt werden soll. Dieser Wert wird aus dem pdwStatus-Parameter von IWMDRMDeviceApp::QueryDeviceStatus oder IWMDRMDeviceApp2::QueryDeviceStatus2 abgerufen. Sie können das pdwStatus-Flag direkt verwenden.

Flag	Beschreibung
WMDRM_DEVICE_NEEDCLOCK	Rufen Sie eine Uhr von einem sicheren Uhrserver ab.
WMDRM_DEVICE_REFRESHCLOCK	Aktualisieren Sie die Uhr von einem sicheren Uhrserver.

pdwStatus [out]

Einer der folgenden DWORD-Werte, die die vom Gerät zurückgegebenen status angeben.

Status	BESCHREIBUNG
0	Die Aktion wird nicht unterstützt.
1	Die sichere Uhr des Geräts konnte nicht vom Dienst abgerufen werden.
2	Die sichere Uhr des Geräts konnte nicht festgelegt werden.
3	Die sichere Uhr des Geräts wurde festgelegt.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
DRM_E_INVALIDARG	Mindestens ein Argument ist ungültig.
NS_E_DEVICE_NOT_WMDRM_DEVICE	Das angegebene Gerät ist kein Windows Media DRM-kompatibles Gerät.
NS_E_DRM_UNABLE_TO_GET_SECURE_CLOCK	Fehler beim Abrufen der Secure Clock Challenge vom Gerät oder Nicht abrufen der URL für die sichere Uhr aus der Herausforderung.
NS_E_DRM_UNABLE_TO_GET_SECURE_CLOCK_FROM_SERVER	Fehler beim Abrufen der Antwort für die sichere Uhr vom Server für die sichere Uhr.
NS_E_DRM_UNABLE_TO_SET_SECURE_CLOCK	Fehler beim Senden der Secure Clock Challenge an das Gerät, oder das Gerät konnte die Uhr nicht festlegen.

Bemerkungen

Dies ist eine asynchrone Methode. das Gerät muss auf den IWMDMProgress::End-Rückruf für diesen Vorgang warten, bevor versucht wird, lizenzierte Inhalte wiederzugeben.

Eine Anwendung kann erfahren, ob das Gerät die Uhr zurücksetzen oder aktualisieren muss, indem sie IWMDRMDeviceApp::QueryDeviceStatus oder IWMDRMDeviceApp2::QueryDeviceStatus2 aufruft.

Ihre Anwendung muss über eine Internetverbindung verfügen, damit sie eine sichere Uhr abrufen oder zurücksetzen kann.

Anforderungen

Anforderung	Wert
Header	WMDRMDeviceApp.h (erfordert auch Wmdrmdeviceapp_i.c, erstellt aus WMDRMDeviceApp.idl)
Bibliothek	Mssachlp.lib

Weitere Informationen

Behandeln geschützter Inhalte in der Anwendung
IWMDMDevice-Schnittstelle
IWMDMProgress3-Schnittstelle
IWMDRMDeviceApp-Schnittstelle

Freigeben über