IWMDRMDeviceApp2::QueryDeviceStatus2-Methode
Die QueryDeviceStatus2-Methode fragt ein Gerät nach einer bestimmten DRM-status oder -Funktion ab.
Syntax
HRESULT QueryDeviceStatus2(
[in] IWMDMDevice *pDevice,
[in] DWORD dwFlags,
[out] DWORD *pdwStatus
);
Parameter
-
pDevice [in]
-
Zeiger auf ein IWMDMDevice-Objekt .
-
dwFlags [in]
-
Mindestens einer der folgenden DWORD-Werte , die angeben, welche Funktionen angefordert werden sollen, kombiniert mit einem bitweisen OR.
Flag Beschreibung WMDRM_QUERY_CLIENT_INDIVSTATUS Fragen Sie ab, ob die DRM-Komponenten des Computers individualisiert werden müssen. WMDRM_QUERY_DEVICE_CLOCKSTATUS Fragen Sie ab, ob die sichere Uhr des Geräts hinzugefügt oder aktualisiert werden muss. WMDRM_QUERY_DEVICE_ISREVOKED Fragen Sie ab, ob das Gerät gesperrt ist. WMDRM_QUERY_DEVICE_ISWMDRM Fragen Sie ab, ob das Gerät Windows Media DRM 10 für tragbare Geräte unterstützt. -
pdwStatus [out]
-
Null oder mehr der folgenden DWORD-Werte, die das angeforderte Gerät status angeben, kombiniert mit einem bitweisen OR.
Status BESCHREIBUNG WMDRM_DEVICE_ISWMDRM Das Gerät unterstützt Windows Media DRM. WMDRM_DEVICE_NEEDCLOCK Das Gerät verfügt nicht über eine sichere Uhr. WMDRM_DEVICE_REVOKED Das Gerät wurde widerrufen. WMDRM_CLIENT_NEEDINDIV Die DRM-Komponenten des Computers müssen individualisiert werden. WMDRM_DEVICE_REFRESHCLOCK Die Uhr muss aktualisiert werden.
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 vom Gerät abgerufene Gerätezertifikat ist ungültig. |
|
Fehler beim Abrufen des Gerätezertifikats vom Gerät. |
Bemerkungen
Diese Methode sollte aufgerufen werden, bevor eingeschränkte Aktionen für DRM-Inhalte ausgeführt werden, z. B. das Übertragen von DRM-Inhalten auf das Gerät oder das Abrufen von Verbrauchsinformationen. Wenn die von pdwStatus abgerufenen Werte angeben, dass eine Aktion ausgeführt werden muss (z. B. Individualisierung für den Desktop oder Abrufen einer Uhr für das Gerät), sollte die Anwendung IWMDRMDeviceApp::AcquireDeviceData aufrufen und den abgerufenen pdwStatus-Wert aus dieser Funktion an den dwFlags-Parameter in AcquireDeviceData übergeben. Wenn null zurückgegeben wird, unterstützt das Gerät Windows Media DRM 10 für tragbare Geräte nicht, und es müssen keine Aktionen ausgeführt werden. Weitere Informationen finden Sie unter Behandeln geschützter Inhalte in der Anwendung .
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|