IWMDRMDeviceApp::SynchronizeLicenses-Methode

Die SynchronizeLicenses-Methode aktualisiert Lizenzen auf einem Gerät, wenn sie demnächst ablaufen.

Syntax

HRESULT SynchronizeLicenses(
  [in] IWMDMDevice    *pDevice,
  [in] IWMDMProgress3 *pProgressCallback,
  [in] DWORD          cMinCountThreshold,
  [in] DWORD          cMinHoursThreshold
);

Parameter

pDevice [ In]

Zeiger auf ein IWMDMDevice-Objekt.

pProgressCallback [ In]

Statusrückruf, der den Fortschritt aller Schritte empfängt, die ggf. ausgeführt werden müssen. Der Schritt wird durch den EventId-Parameter der aufgerufenen IWMDMProgress3-Methode identifiziert.

cMinCountThreshold [ In]

Optionale Mindestanzahl verbleibender Wiedergaben für eine Gerätelizenz.

cMinHoursThreshold [ In]

Optionale verbleibende Mindeststunden für eine Gerätelizenz.

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.
DRM _ E _ INVALIDARG
Mindestens ein Argument ist ungültig.
DRM _ E _ INVALIDXMLTAG
XML ist nicht ordnungsgemäß formatiert.
DRM _ E _ NOTIMPL
Diese Funktionalität ist derzeit nicht implementiert. (SyncLicenses w/ pDevice =NULL)
DRM _ E _ NOXMLCLOSETAG
Die Lizenz-XML wurde nicht ordnungsgemäß formatiert.
DRM _ E _ NOXMLOPENTAG
Die Lizenz-XML wurde nicht ordnungsgemäß formatiert.
DRM _ E _ OUTOFMEMORY
Nicht genügend Arbeitsspeicher.
DRM _ E _ XMLNOTFOUND
Fehler beim Suchen eines erforderlichen XML-Tags in der Lizenz.
NS _ E _ DEVICE _ NOT _ WMDRM _ DEVICE
Das angegebene Gerät ist kein Windows Medien-DRM-kompatibles Gerät.
NS _ E _ DRM ERFORDERT _ _ INDIVIDUALISIERUNG
Das DRM erfordert eine individualisierte Blackbox, um diese Funktion auszuführen. Anders ausgedrückt: Das Windows Media Format SDK erfordert ein Sicherheitsupgrade.

Hinweise

Dieser Aufruf kann nur auf einem Gerät erfolgen, das Windows Media DRM 10 für portable Geräte unterstützt. Sie müssen mindestens einen Schwellenwertparameter angeben.

Anforderungen

Anforderung Wert
Header
WMDRMDeviceApp.h (erfordert auch Wmdrmdeviceapp _ i.c, erstellt aus WMDRMDeviceApp.idl)
Bibliothek
Mssachlp.lib

Siehe auch

Behandeln von geschützten Inhalten in der Anwendung

IWMDMProgress3-Schnittstelle

IWMDRMDeviceApp-Schnittstelle