IWMDRMLicenseManagement：：CleanLicenseStore 方法

[與此頁面相關聯的功能 Windows Media Format 11 SDK是舊版功能。 來源讀取器和接收寫入器已取代它。 來源讀取器和接收寫入器已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用來源讀取器和接收寫入器，而不是Windows 媒體格式 11 SDK。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。

CleanLicenseStore方法會從暫存授權存放區中移除無法使用的授權，並重組本機授權存放區以改善效能。

語法

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

參數

dwFlags [in]

旗標，指定要使用的授權存放區清除選項。 設定為下表中的其中一個常數。

常數	描述
WMDRM_CLEAN_LICENSE_STORE_SYNC	清除作業將會同步執行。 在作業完成之前，此方法不會傳回。
WMDRM_CLEAN_LICENSE_STORE_ASYNC	清除作業將會以非同步方式執行。 這個方法會立即傳回。 作業完成時，將會傳送媒體事件 MELicenseStoreCleaned。

ppunkCancelationCookie [out]

接收物件之 IUnknown 介面指標的指標，可識別這個非同步呼叫。 這個介面指標可用來藉由呼叫 IWMDRMEventGenerator：：CancelAsyncOperation 方法來取消非同步呼叫。

傳回值

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼	描述
S_OK	此方法已成功。
DRM_E_LICENSENOTFOUND	用戶端電腦上沒有暫時的授權存放區。

備註

這個方法會以非同步方式執行。 它會在呼叫之後立即傳回，然後在處理完成時產生 MEWMDRMLicenseStoreCleaned 事件。

如需使用 Windows 媒體 DRM 用戶端擴充 API 非同步方法的詳細資訊，請參閱 使用媒體基礎事件模型。

規格需求

需求	值
標頭	Wmdrmsdk.h
程式庫	Wmdrmsdk.lib

另請參閱

IWMDRMLicenseManagement 介面