IWMDRMDeviceApp::AcquireDeviceData-Methode
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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Mindestens ein Argument ist ungültig. |
|
Das angegebene Gerät ist kein Windows Media DRM-kompatibles Gerät. |
|
Fehler beim Abrufen der Secure Clock Challenge vom Gerät oder Nicht abrufen der URL für die sichere Uhr aus der Herausforderung. |
|
Fehler beim Abrufen der Antwort für die sichere Uhr vom Server für die sichere Uhr. |
|
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 |
|
| Bibliothek |
|