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 |
|