IWMDRMLicenseQuery::QueryActionAllowed-Methode

[Das dieser Seite zugeordnete Feature Windows Media Format 11 SDK ist ein Legacyfeature. Sie wurde durch den Quellleser und den Senkenschreiber ersetzt. Quellleser und Senkenschreiber wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit den Quellleser und senkenden Writer anstelle des Windows Media Format 11 SDK verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die QueryActionAllowed-Methode führt eine Abfrage im lokalen Lizenzspeicher aus, um die Lizenz status 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, nach der abfragt werden soll. Es werden nur Lizenzen ausgewertet, die für diese Schlüssel-ID gelten.

bstrMinReqIndivVersion [in]

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

cActionsToQuery [in]

Die Anzahl der Aktionen, für die eine Abfrage durchgeführt werden soll. 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 eine Abfrage ausgeführt 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	Schließen Sie ein, um das Recht zum Wiedergeben des Inhalts abzufragen.
g_wszWMDRM_ActionAllowed_Copy	Schließen Sie ein, um das Recht abzufragen, den Inhalt auf externe Geräte oder Medien zu kopieren.
g_wszWMDRM_ActionAllowed_PlaylistBurn	Include to query for the right to copy the content to CD as part of a playlist.
g_wszWMDRM_ActionAllowed_CreateThumbnailImage	Fügen Sie ein, um das Recht zum Erstellen eines Miniaturbilds aus dem Inhalt abzufragen.
g_wszWMDRM_ActionAllowed_CopyToCD	Fügen Sie ein, um das Recht zum Kopieren des Inhalts auf CD abzufragen.

rgdwQueryResult[] [out]

Array einer oder mehrerer DWORD-Variablen, die die Ergebnisse der Abfrage für die von rgbstrActionsToQuery angegebenen Rechte empfangen. Wenn eine Aktion zulässig ist, wird das entsprechende Element auf null festgelegt. Wenn eine Aktion nicht zulässig ist, wird das Element auf einen oder mehrere Werte der DRM_ACTION_ALLOWED_QUERY_RESULTS Enumeration festgelegt, die mithilfe des bitweisen OR-Vorgangs kombiniert wird. 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.

Bemerkungen

Beim Abfragen nach Wiedergabe- und Kopierrechten erhalten Sie genauere Ergebnisse, indem Sie zuerst Umgebungsparameter festlegen. Verwenden Sie die SetActionAllowedQueryParams-Methode , um die Umgebungsparameter festzulegen. Die Ergebnisse von Abfragen nach dem Brennrecht bleiben von den Umgebungsparametern unberührt; Sie können die Standardwerte sicher verwenden.

Die von der QueryActionAllowed-Methode zurückgegebenen Ergebnisse werden aus 0 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 gefunden wird.

Anforderungen

Anforderung	Wert
Header	Wmdrmsdk.h
Bibliothek	Wmdrmsdk.lib

Siehe auch

IWMDRMLicenseQuery-Schnittstelle

Abfragen von Informationen zu einfachen Rechten