WM _ GET _ LICENSE _ DATA-Struktur

Die WM GET LICENSE _ _ _ DATA-Struktur enthält Informationen dazu, wo eine DRM-Lizenz erworben werden kann.

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

Auf NULL endende Zeichenfolge mit Breitzeichen, die die Lizenzerwerbs-URL enthält. Verwenden Sie diese Zeichenfolge und die pbPostData-Zeichenfolge beim nicht automatischen Lizenzerwerb.

wszLocalFilename

Auf NULL endende Zeichenfolge mit Breitzeichen, 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 zusammen mit den erforderlichen Postdaten automatisch an die Lizenzerwerbs-URL um. Die Verwendung dieser lokalen URL ist jetzt veraltet. Es wird empfohlen, 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 am Anfang der pbPostData-Zeichenfolge die folgende Zeichenfolge hinzufügen: "nonsilent=1&challenge=". Die resultierende Zeichenfolge sollte dann beim Erstellen der HTTP-Anforderung an wszURL angefügt werden.

dwPostDataSize

DWORD, das die Größe von pbPostData ohne die Zeichenfolge "nonsilent=1&challenge=" angibt, auf die in pbPostData verwiesen wird.

Hinweise

Diese ausgefüllte Struktur wird im pValue-Parameter der IWMStatusCallback::OnStatus-Methode zurückgegeben, wenn WMT _ STATUS gleich WMT _ NO RIGHTS _ _ EX oder WMT ACQUIRE _ _ LICENSE ist. Bei WMT _ NO _ RIGHTS _ EX-Ereignissen ist das HR-Mitglied NS E _ LICENSE _ _ REQUIRED, NS _ E LICENSE _ _ OUTOFDATE oder NS _ E LICENSE INCORRECT _ _ _ RIGHTS. Jeder dieser Fehler gibt an, dass eine neue Lizenz erworben werden muss, indem Sie zur URL im wszURL-Mitglied navigieren.

Bei WMT _ ACQUIRE _ LICENSE-Ereignissen übergibt das hr-Mitglied das SUCCEEDED-Makro, wenn eine Lizenz erfolgreich erworben wurde. Wenn dieses Ereignis nach einem Versuch der automatischen Übernahme empfangen wird und hr gleich NS _ E _ DRM LICENSE _ _ NOTACQUIRED ist, gibt dies an, dass nur der nicht automatische 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

Weitere Informationen

IWMDRMReader::AcquireLicense

Strukturen