IWMDRMDeviceApp2::QueryDeviceStatus2-Methode

Artikel
06/13/2023

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
S_OK	Die Methode wurde erfolgreich ausgeführt.
DRM_E_INVALIDARG	Mindestens ein Argument ist ungültig.
NS_E_DRM_INVALID_CERTIFICATE	Das vom Gerät abgerufene Gerätezertifikat ist ungültig.
NS_E_DRM_UNABLE_TO_GET_DEVICE_CERT	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	WMDRMDeviceApp.h (erfordert auch Wmdrmdeviceapp_i.c, erstellt aus WMDRMDeviceApp.idl)
Bibliothek	Mssachlp.lib

Siehe auch

Behandeln von geschützten Inhalten in der Anwendung
IWMDRMDeviceApp::QueryDeviceStatus
IWMDRMDeviceApp2-Schnittstelle

Freigeben über