共用方式為


IWMDRMDeviceApp::SynchronizeLicenses 方法

SynchronizeLicenses方法會在裝置即將到期時更新授權。

語法

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

參數

pDevice [in]

IWMDMDevice物件的指標。

pProgressCallback [in]

進度回呼,將會收到可能需要執行之任何步驟的進度。步驟是由呼叫之 IWMDMProgress3方法的EventId參數所識別。

cMinCountThreshold [in]

裝置授權上的選擇性剩餘播放次數下限。

cMinHoursThreshold [in]

裝置授權的選擇性最小剩餘時數。

傳回值

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

傳回碼 描述
S_OK
此方法已成功。
DRM_E_INVALIDARG
一或多個引數無效。
DRM_E_INVALIDXMLTAG
XML 的格式不正確。
DRM_E_NOTIMPL
這項功能目前未實作。 (SyncLicenses w/ pDevice =Null)
DRM_E_NOXMLCLOSETAG
授權 XML 的格式不正確。
DRM_E_NOXMLOPENTAG
授權 XML 的格式不正確。
DRM_E_OUTOFMEMORY
記憶體不足。
DRM_E_XMLNOTFOUND
在授權中找不到必要的 XML 標記。
NS_E_DEVICE_NOT_WMDRM_DEVICE
指定的裝置不是 Windows 媒體 DRM 相容的裝置。
NS_E_DRM_NEEDS_INDIVIDUALIZATION
DRM 需要個別的黑色方塊才能執行此函式。 換句話說,Windows 媒體格式 SDK 需要安全性升級。

備註

此呼叫只能在支援適用于可攜式裝置的 Windows Media DRM 10 的裝置上進行。 您必須至少指定一個臨界值參數。

規格需求

需求
標頭
WMDRMDeviceApp.h (也需要從 WMDRMDeviceApp.idl) 建置的 Wmdrmdeviceapp_i.c
程式庫
Mssachlp.lib

另請參閱

處理應用程式中受保護的內容

IWMDMProgress3 介面

IWMDRMDeviceApp 介面