IWMDMStorage4::GetRightsWithProgress-Methode (mswmdm.h)

Die GetRightsWithProgress-Methode ruft die Rechteinformationen für das Speicherobjekt ab und stellt einen Rückrufmechanismus zum Überwachen des Fortschritts bereit.

Syntax

HRESULT GetRightsWithProgress(
  [in]  IWMDMProgress3 *pIProgressCallback,
  [out] PWMDMRIGHTS    *ppRights,
  [out] UINT           *pnRightsCount
);

Parameter

[in] pIProgressCallback

Optionaler Zeiger auf eine IWMDMProgress3-Schnittstelle, die von Windows Media Geräte-Manager verwendet werden soll, um den Fortschritt zurück an die Anwendung zu melden.

[out] ppRights

Zeiger auf ein Array von WMDMRIGHTS-Strukturen , die die Informationen zu Speicherobjektrechten enthalten. Der Arbeitsspeicher für dieses Array wird von Windows Media Geräte-Manager zugewiesen. Wenn die aufrufende Anwendung den Zugriff auf dieses Array beendet hat, muss der Arbeitsspeicher mithilfe von CoTaskMemFree freigegeben werden.

[out] pnRightsCount

Zeiger auf die Anzahl der WMDMRIGHTS-Strukturen im ppRights-Array .

Rückgabewert

Die Methode gibt ein HRESULT zurück. Alle Schnittstellenmethoden in Windows Media Geräte-Manager können eine der folgenden Klassen von Fehlercodes zurückgeben:

• Standard-COM-Fehlercodes
• In HRESULT-Werte konvertierte Windows-Fehlercodes
• Windows Media Geräte-Manager Fehlercodes

Hinweise

Objektrechte beschreiben die Nutzungsberechtigungen für digitale Medieninhalte. Beispielsweise kann die WMDMRIGHTS-Struktur Informationen darüber enthalten, wie oft eine Datei wiedergegeben werden kann und wer sie wiedergeben kann.

Das Abrufen von Rechten aus einer lizenzierten Datei kann manchmal eine langwierige Anforderung sein. Mit dieser Funktion kann eine Rechteanforderung asynchron ausgeführt werden.

Der Anbieter sicherer Inhalte kann zusätzlich zu den Statusbenachrichtigungen Ereignisbenachrichtigungen für den Rückruf pIProgressCallback generieren. Beispiele für solche Ereignisse sind das Abrufen einer sicheren Uhr, das Initialisieren von DRM usw. Diese Ereignisse werden unter IWMDMProgress3::P rogress3 beschrieben.

Diese Methode ist mit IWMDMStorage::GetRights identisch, mit der Ausnahme, dass sie den Fortschritt zurückgibt, und stellt keinen MAC für die Parameterüberprüfung bereit.

Anforderungen

Weitere Informationen

IWMDMStorage4-Schnittstelle