IWMDRMLicenseQuery::QueryLicenseState-Methode

Artikel
06/21/2023

[Das dieser Seite zugeordnete Feature Windows Media Format 11 SDK ist ein Legacyfeature. Es wurde von Source Reader und Sink Writer abgelöst. Source Reader und Sink Writer wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit quellleser und Senkenschreiber anstelle des Windows Media Format 11 SDK verwendet. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die QueryLicenseState-Methode fragt den lokalen Lizenzspeicher nach Lizenzinformationen ab, die für eine Schlüssel-ID für ein oder mehrere bestimmte Rechte gelten.

Syntax

HRESULT QueryLicenseState(
  [in]  BSTR                   bstrKID,
  [in]  DWORD                  cActionsToQuery,
  [in]  BSTR                   rgbstrActionsToQuery[],
  [out] DRM_LICENSE_STATE_DATA rgResultStateData[]
);

Parameter

bstrKID [in]

Schlüssel-ID, nach der abfragt werden soll. Es werden nur Lizenzen ausgewertet, die für diese Schlüssel-ID gelten.

cActionsToQuery [in]

Die Anzahl der Abzufragenden Aktionen. Dieser Wert muss auf die Anzahl der Elemente in den Arrays festgelegt werden, die für die Parameter rgbstrActionsToQuery und rgResultStateData ü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_LicenseState_Backup	Schließen Sie ein, um die Details zum Recht zum Sichern und Wiederherstellen der Lizenz abzufragen.
g_wszWMDRM_LicenseState_CollaborativePlay	Schließen Sie ein, um die Details zum Recht abzufragen, den Inhalt für eine Gruppe von Benutzern im Rahmen eines szenarios für die gemeinsame Wiedergabe zu teilen.
g_wszWMDRM_LicenseState_Copy	Schließen Sie ein, um die Details zum Recht zum Kopieren des Inhalts auf externe Geräte oder Medien abzufragen.
g_wszWMDRM_LicenseState_CopyToCD	Schließen Sie ein, um die Details zum Recht zum Kopieren des Inhalts auf CD abzufragen.
g_wszWMDRM_LicenseState_CopyToNonSDMIDevice	Schließen Sie ein, um Details zum Recht zum Kopieren der Inhalte auf ein Gerät abzufragen, das die Initiative für sichere digitale Medien (SDMI) nicht unterstützt.
g_wszWMDRM_LicenseState_CopyToSDMIDevice	Schließen Sie ein, um die Details zum Recht abzufragen, den Inhalt auf ein Gerät zu kopieren, das die SDMI unterstützt.
g_wszWMDRM_LicenseState_CreateThumbnailImage	Schließen Sie ein, um die Details zum Recht zum Erstellen eines Miniaturbilds aus dem Inhalt abzufragen.
g_wszWMDRM_LicenseState_Playback	Schließen Sie ein, um die Details zum Recht zum Wiedergeben des Inhalts abzufragen.
g_wszWMDRM_LicenseState_PlaylistBurn	Schließen Sie ein, um die Details zum Recht abzufragen, den Inhalt als Teil einer Wiedergabeliste auf CD zu kopieren.

rgResultStateData[] [out]

Array einer oder mehrerer DRM_LICENSE_STATE_DATA Strukturen, die die Lizenzstatusinformationen erhalten, die rechts im entsprechenden Element des rgbstrActionsToQuery-Parameters gelten.

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

Alle Lizenzen, die für die angegebene Schlüssel-ID gelten, werden durchsucht und ausgewertet. Die Ergebnisse werden aggregiert, sodass jede DRM_LICENSE_STATE_DATA Struktur Informationen aus mehreren Lizenzen enthalten kann.

Anforderungen

Anforderung	Wert
Header	Wmdrmsdk.h
Bibliothek	Wmdrmsdk.lib

Siehe auch

IWMDRMLicenseQuery-Schnittstelle

Freigeben über