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