IMDSPStorage::GetRights-Methode (mswmdm.h)

Die GetRights-Methode ruft die Rechteinformationen für ein Objekt ab.

Syntax

HRESULT GetRights(
  [out]     PWMDMRIGHTS *ppRights,
  [out]     UINT        *pnRightsCount,
  [in, out] BYTE [8]    abMac
);

Parameter

[out] ppRights

Zeiger auf ein Array von WMDMRIGHTS-Strukturen , die die Informationen zu Speicherobjektrechten enthalten. Dieser Parameter ist im Authentifizierungscode der Ausgabemeldung enthalten.

[out] pnRightsCount

Zeiger auf die Anzahl der WMDMRIGHTS-Strukturen im ppRights-Array . Dieser Parameter ist im Authentifizierungscode der Ausgabemeldung enthalten.

[in, out] abMac

Array von acht Bytes, die den Nachrichtenauthentifizierungscode für die Parameterdaten dieser Methode enthalten. (WMDM_MAC_LENGTH ist als 8 definiert.)

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:

  • Com-Standardfehlercodes
  • In HRESULT-Werte konvertierte Windows-Fehlercodes
  • Windows Media Geräte-Manager Fehlercodes
Eine ausführliche Liste möglicher Fehlercodes finden Sie unter Fehlercodes.

Hinweise

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

Das ppRights-Array wird von dieser Methode zugeordnet und muss von der Anwendung mithilfe von CoTaskMemFree, einer Win32-Standardfunktion, freigegeben werden.

Diese Methode ist optional. Weitere Informationen finden Sie unter Obligatorische und optionale Schnittstellen.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile mswmdm.h
Bibliothek Mssachlp.lib

Weitere Informationen

IMDSPStorage-Schnittstelle

WMDMRIGHTS