IWMDRMLicenseManagement::AcquireLicense-Methode

[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 AcquireLicense-Methode ruft asynchron eine Lizenz von einer angegebenen URL ab.

Syntax

HRESULT AcquireLicense(
  [in]  BSTR     bstrURL,
  [in]  BSTR     bstrHeaderData,
  [in]  BSTR     bstrActions,
  [in]  DWORD    dwFlags,
  [out] IUnknown **ppunkCancelationCookie
);

Parameter

bstrURL [in]

URL des Lizenzservers, von dem die Lizenz erworben werden soll. Übergeben Sie NULL , damit die -Methode die URL aus dem Inhaltsheader analysiert.

bstrHeaderData [in]

Inhaltsheader, der an den Lizenzserver übergeben werden soll. Wenn bstrURLNULL ist, analysiert die Methode die URL aus diesem Header. Wenn dwFlags auf WMDRM_ACQUIRE_LICENSE_LEGACY_NONSILENT festgelegt ist, legen Sie diesen Wert anstelle des gesamten Inhaltsheaders auf die Schlüssel-ID fest.

bstrActions [in]

Zeichenfolge, die null oder mehr Aktionen enthält, für die die Berechtigung in der Lizenz angefordert werden soll. Die Zeichenfolge muss wie folgt formatiert sein:

• Jede Aktion muss in einem ACTION-Element definiert werden. Die Daten des Elements sind die Aktionszeichenfolge.

• Alle ACTION-Elemente müssen in einem ACTIONLIST-Element enthalten sein.

  Die Zeichenfolge zum Anfordern einer Lizenz zum Wiedergeben von Inhalten ist beispielsweise wie folgt formatiert:

  <ACTIONLIST><ACTION></ACTION></ACTIONLIST>
  

dwFlags [in]

Flags für lizenzerwerbsoption. Legen Sie auf eine der Konstanten in der folgenden Tabelle fest.

Konstante	BESCHREIBUNG
WMDRM_ACQUIRE_LICENSE_SILENT	Die Lizenz wird ohne Bestätigung der Clientanwendung direkt über das Internet ausgestellt.
WMDRM_ACQUIRE_LICENSE_NONSILENT	Das DRM-Subsystem erstellt eine Lizenzanforderung, die asynchron zur Veröffentlichung auf dem Lizenzserver zurückgegeben wird.
WMDRM_ACQUIRE_LICENSE_LEGACY_NONSILENT	Dasselbe wie WMDRM_ACQUIRE_LICENSE_NONSILENT, mit der Ausnahme, dass eine DRM-Lizenzanforderung Version 1 erstellt wird.

ppunkCancelationCookie [out]

Zeiger, der einen Zeiger auf die IUnknown-Schnittstelle eines Objekts empfängt, das diesen asynchronen Aufruf identifiziert. Dieser Schnittstellenzeiger kann verwendet werden, um den asynchronen Aufruf durch Aufrufen der IWMDRMEventGenerator::CancelAsyncOperation-Methode abzubrechen.

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

Diese Methode wird asynchron ausgeführt. Es wird unmittelbar nach dem Aufruf zurückgegeben und dann nach Abschluss der Verarbeitung ein MEWMDRMLicenseAcquisitionCompleted-Ereignis generiert. Bei nicht automatischen Lizenzerwerbsvorgängen ist der Wert des Ereignisses, das durch Aufrufen von IMFMediaEvent::GetValue abgerufen wird, ein IUnknown-Zeiger . Sie können die QueryInterface-Methode der abgerufenen IUnknown-Schnittstelle aufrufen, um eine instance der IWMDRMNonSilentLicenseAquisition-Schnittstelle abzurufen.

Weitere Informationen zur Verwendung der asynchronen Methoden der erweiterten Windows Media DRM-Client-APIs finden Sie unter Verwenden des Media Foundation-Ereignismodells.

Anforderungen

Anforderung	Wert
Header	Wmdrmsdk.h
Bibliothek	Wmdrmsdk.lib

Siehe auch

IWMDRMLicenseManagement-Schnittstelle

Unbeaufsichtigter Lizenzerwerb