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
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 |