Freigeben über


IWMDRMLicenseManagement::CleanLicenseStore-Methode

[Das dieser Seite zugeordnete Feature Windows Media Format 11 SDK ist ein Legacyfeature. Es wurde von Source Reader und Sink Writer abgelöst. Source Reader und Sink Writer wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit quellleser und Senkenschreiber anstelle des Windows Media Format 11 SDK verwendet. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die CleanLicenseStore-Methode entfernt nicht verwendbare Lizenzen aus dem temporären Lizenzspeicher und defragmentiert den lokalen Lizenzspeicher, um die Leistung zu verbessern.

Syntax

HRESULT CleanLicenseStore(
  [in]  DWORD    dwFlags,
  [out] IUnknown **ppunkCancelationCookie
);

Parameter

dwFlags [in]

Flags, die die zu verwendenden Optionen für die Bereinigung des Lizenzspeichers angeben. Legen Sie auf eine der Konstanten in der folgenden Tabelle fest.

Konstante Beschreibung
WMDRM_CLEAN_LICENSE_STORE_SYNC Der sauber Vorgang wird synchron ausgeführt. Diese Methode wird erst zurückgegeben, wenn der Vorgang abgeschlossen ist.
WMDRM_CLEAN_LICENSE_STORE_ASYNC Der sauber Vorgang wird asynchron ausgeführt. Diese Methode wird sofort zurückgegeben. Wenn der Vorgang abgeschlossen ist, wird das Medienereignis MELicenseStoreCleaned gesendet.

ppunkCancelationCookie [out]

Zeiger, der einen Zeiger auf die IUnknown-Schnittstelle eines Objekts empfängt, das diesen asynchronen Aufruf identifiziert. Dieser Schnittstellenzeiger kann verwendet werden, um den asynchronen Aufruf durch Aufrufen der IWMDRMEventGenerator::CancelAsyncOperation-Methode abzubrechen.

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_LICENSENOTFOUND
Auf dem Clientcomputer ist kein temporärer Lizenzspeicher vorhanden.

Bemerkungen

Diese Methode wird asynchron ausgeführt. Es wird unmittelbar nach dem Aufruf zurückgegeben und dann ein MEWMDRMLicenseStoreCleaned-Ereignis generiert, wenn die Verarbeitung abgeschlossen ist.

Weitere Informationen zur Verwendung der asynchronen Methoden der erweiterten Windows Media DRM-Client-APIs finden Sie unter Verwenden des Media Foundation-Ereignismodells.

Anforderungen

Anforderung Wert
Header
Wmdrmsdk.h
Bibliothek
Wmdrmsdk.lib

Siehe auch

IWMDRMLicenseManagement-Schnittstelle