IWMDRMLicenseQuery::QueryActionAllowed-Methode

Die QueryActionAllowed-Methode führt eine Abfrage für den lokalen Lizenzspeicher aus, um den Lizenzstatus für eine oder mehrere DRM-Aktionen abzurufen, die für eine angegebene Schlüssel-ID gelten.

Syntax

HRESULT QueryActionAllowed(
  [in]  BSTR  bstrKID,
  [in]  BSTR  bstrMinReqIndivVersion,
  [in]  DWORD cActionsToQuery,
  [in]  BSTR  rgbstrActionsToQuery[],
  [out] DWORD rgdwQueryResult[]
);

Parameter

bstrKID [ In]

Schlüssel-ID, für die abgefragt werden soll. Nur Lizenzen, die für diese Schlüssel-ID gelten, werden ausgewertet.

bstrMinReqIndivVersion [ In]

Die im Header der ASF-Datei angegebene Mindestsicherheitsversion. Dieser Parameter ist optional. Übergeben Sie NULL, um die Abfrage ohne diese Informationen auszuführen.

cActionsToQuery [ In]

Die Anzahl der Aktionen, die abgefragt werden sollen. Dieser Wert muss auf die Anzahl der Elemente in den Arrays festgelegt werden, die für die Parameter rgbstrActionsToQuery und rgdwQueryResult übergeben werden.

rgbstrActionsToQuery [ ] [in]

Array mit mindestens einer Berechtigung, für die abgefragt werden soll. Dieses Array muss so viele Elemente enthalten, wie von cActionsToQuery angegeben. Jedes Element muss auf eine der folgenden Konstanten festgelegt werden:

Konstante Beschreibung
g _ wszWMDRM _ ActionAllowed _ Playback Fügen Sie ein, um die Berechtigung zum Wiedergeben des Inhalts abzufragen.
g _ wszWMDRM _ ActionAllowed _ Copy Schließen Sie ein, um die Berechtigung zum Kopieren des Inhalts auf externe Geräte oder Medien abzufragen.
g _ wszWMDRM _ ActionAllowed _ Playlist Überschreiben Schließen Sie ein, um die Berechtigung abzufragen, den Inhalt als Teil einer Wiedergabeliste auf CD zu kopieren.
g _ wszWMDRM _ ActionAllowed _ CreateThumbnailImage Schließen Sie ein, um die Rechte abzufragen, um ein Miniaturbild aus dem Inhalt zu erstellen.
g _ wszWMDRM _ ActionAllowed _ CopyToCD Fügen Sie ein, um die Berechtigung zum Kopieren des Inhalts auf CD abzufragen.

rgdwQueryResult [ ] [out]

Array von einer oder mehreren DWORD-Variablen, die die Ergebnisse der Abfrage für die durch rgbstrActionsToQuery angegebenen Rechte empfangen. Wenn eine Aktion zulässig ist, wird das entsprechende Element auf 0 (null) festgelegt. Wenn eine Aktion nicht zulässig ist, wird das Element mithilfe des bitweisen OR-Vorgangs auf einen oder mehrere Werte der DRM _ ACTION ALLOWED _ QUERY _ _ RESULTS-Enumeration festgelegt. Dieses Array muss so viele Elemente enthalten, wie von cActionsToQuery angegeben.

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.

Hinweise

Wenn Sie Wiedergabe- und Kopierrechte abfragen, erhalten Sie genauere Ergebnisse, indem Sie zuerst Umgebungsparameter festlegen. Verwenden Sie die SetActionAllowedQueryParams-Methode, um die Umgebungsparameter festzulegen. Die Ergebnisse von Abfragen für das Brandrecht sind von den Umgebungsparametern nicht betroffen. Sie können die Standardwerte sicher verwenden.

Die von der QueryActionAllowed-Methode zurückgegebenen Ergebnisse werden aus null oder mehr Lizenzen im lokalen Lizenzspeicher aggregiert. Die -Methode durchsucht möglicherweise nicht alle Lizenzen, die für die Schlüssel-ID gelten, wenn ein aktiviertes Ergebnis auftritt.

Anforderungen

Anforderung Wert
Header
Wmdrmsdk.h
Bibliothek
Wmdrmsdk.lib

Siehe auch

IWMDRMLicenseQuery-Schnittstelle

Abfragen einfacher Rechteinformationen