WM_GET_LICENSE_DATA Struktur

Artikel
06/21/2023

[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 WM_GET_LICENSE_DATA-Struktur enthält Informationen dazu, wo eine DRM-Lizenz erworben werden soll.

Syntax

typedef struct _WMGetLicenseData {
  DWORD   dwSize;
  HRESULT hr;
  WCHAR   *wszURL;
  WCHAR   *wszLocalFilename;
  BYTE    *pbPostData;
  DWORD   dwPostDataSize;
} WM_GET_LICENSE_DATA;

Member

dwSize: DWORD , das die Größe der WM_GET_LICENSE_DATA-Struktur in Bytes enthält.
Std.: HRESULT-Rückgabecode .
wszURL: Zeichenfolge mit Breitzeichen mit NULL-Beendigung, die die Lizenzerwerbs-URL enthält. Verwenden Sie diese Zeichenfolge und die pbPostData-Zeichenfolge beim nicht automatischen Lizenzerwerb.
wszLocalFilename: Zeichenfolge mit breitem Null-Enden, die eine lokale HTML-Seite enthält, die von der DRM-Komponente generiert wird. Wenn diese Zeichenfolge in einen Browser geladen wird, leitet sie die HTTP-Anforderung automatisch an die Lizenzerwerbs-URL um, zusammen mit den erforderlichen Postdaten. Die Verwendung dieser lokalen URL ist jetzt veraltet. Der empfohlene Ansatz besteht darin, die Zeichenfolgen wszURL und pbPostData zu verwenden.
pbPostData: Zeiger auf ein Bytearray, das die Daten enthält, die an die Lizenzerwerbs-URL gesendet werden sollen. Sie müssen die folgende Zeichenfolge am Anfang der pbPostData-Zeichenfolge hinzufügen: "nonsilent=1&challenge=". Die resultierende Zeichenfolge sollte dann an wszURL angefügt werden, wenn Sie die HTTP-Anforderung erstellen.
dwPostDataSize: DWORD , das die Größe von pbPostData ohne die Zeichenfolge "nonsilent=1&challenge=" angibt, auf die in pbPostData verwiesen wird.

Bemerkungen

Diese ausgefüllte Struktur wird im pValue-Parameter der IWMStatusCallback::OnStatus-Methode zurückgegeben, wenn WMT_STATUSWMT_NO_RIGHTS_EX oder WMT_ACQUIRE_LICENSE entspricht. Bei WMT_NO_RIGHTS_EX Ereignissen wird das HR-Mitglied NS_E_LICENSE_REQUIRED, NS_E_LICENSE_OUTOFDATE oder NS_E_LICENSE_INCORRECT_RIGHTS. Jeder dieser Fehler weist darauf hin, dass eine neue Lizenz erworben werden muss, indem Sie zur URL im wszURL-Member navigieren.

Bei WMT_ACQUIRE_LICENSE Ereignissen übergibt das HR-Mitglied das MAKRO SUCCEEDED, wenn eine Lizenz erfolgreich erworben wurde. Wenn dieses Ereignis nach einem Versuch der unbeaufsichtigten Übernahme empfangen wird und hr gleich NS_E_DRM_LICENSE_NOTACQUIRED ist, gibt dies an, dass nur der nicht unbeaufsichtigte Erwerb vom Lizenzserver für diese Lizenz unterstützt wird.

Die Audioplayer-Beispielanwendung veranschaulicht, wie die in dieser Struktur zurückgegebenen Informationen ordnungsgemäß verwendet werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Version	Windows Media Format 7 SDK oder höhere Versionen des SDK
Header	Drmexternals.h

Siehe auch

IWMDRMReader::AcquireLicense
Strukturen

Freigeben über