Aktualisieren von Lizenzen

  • Artikel

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer abgelöst. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, mediaPlayer anstelle von Windows Medienwiedergabe SDK für neuen Code zu verwenden. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Onlineshops können Inhalte bereitstellen, die für einen bestimmten Zeitraum oder bis zu einem bestimmten Datum lizenziert sind. Dies wäre normal für Musikinhalte, die im Rahmen eines Abonnementdienstvertrags bereitgestellt werden. In diesem Fall benötigt der Onlineshop die Möglichkeit, diese Lizenzen vor ablaufen zu aktualisieren, natürlich unter der Annahme, dass der Benutzer für die Verlängerung seines Abonnements bezahlt hat. (Wenn der Benutzer das Abonnement nicht verlängert hat, können die Lizenzen einfach ablaufen.)

Windows Medienwiedergabe fragt das Inhaltspartner-Plug-In ab, wie viel Vorabwarnung der Player zu einer Lizenz geben sollte, die bald abläuft. Dazu wird IWMPContentPartner::GetContentPartnerInfo aufgerufen und die Konstante g_szContentPartnerInfo_LicenseRefreshAdvanceWarning über den bstrInfoName-Parameter übergeben. Um das Plug-In über lizenzen zu informieren, die bald ablaufen, ruft Windows Medienwiedergabe IWMPContentPartner::RefreshLicense auf. Dieser Aufruf verwendet Parameter, die Details zur zu aktualisierenden Datei bereitstellen, z. B. ob sich die Datei auf dem Computer des Benutzers befindet, und den Pfad zur Datei. Wenn die Lizenz im Rahmen eines Gerätesynchronisierungsvorgangs aktualisiert wird, liefert der Parameter pReasonContext den kanonischen Namen des Geräts.

Wenn Windows Medienwiedergabe RefreshLicence aufruft, übergibt er ein Cookie, das die Updateanforderung identifiziert. Wenn das Plug-In die Verarbeitung der Updateanforderung abgeschlossen ist, benachrichtigt es Windows Medienwiedergabe, indem es IWMPContentPartnerCallback::RefreshLicenseComplete aufruft und das Cookie, die ID des Medienelements und ein HRESULT übergibt, das angibt, ob das Update erfolgreich war.

Online-Store-Plug-Ins können auch Lizenzüberprüfungen und Updates als Hintergrundprozess durchführen. Windows Medienwiedergabe benachrichtigt das Plug-In über Die Zeiten, in denen Hintergrundverarbeitungsaufgaben ausgeführt werden dürfen, indem IWMPContentPartner::Notify aufgerufen wird. Um dem Plug-In zu signalisieren, dass die Hintergrundverarbeitung gestartet wird, übergibt der Player den WMPPartnerNotification-Enumerationswert wmpsnBackgroundProcessingBegin; Um dem Plug-In zu signalisieren, die Hintergrundverarbeitung zu beenden, übergibt der Player den Wert wmpsnBackgroundProcessingEnd.

Programmierhandbuch für Typ-1-Onlineshops