Метод IWMDRMDeviceApp::SynchronizeLicenses

Статья
06/13/2023

Метод SynchronizeLicenses обновляет лицензии на устройстве, когда срок их действия близок к истечению срока действия.

Синтаксис

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

Параметры

pDevice [in]: Указатель на объект IWMDMDevice .
pProgressCallback [in]: Обратный вызов progress, который будет получать ход выполнения всех шагов, которые может потребоваться выполнить. Шаг определяется параметром EventId вызываемого метода IWMDMProgress3 .
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	Указанное устройство не является устройством, совместимым с DRM Windows Media.
NS_E_DRM_NEEDS_INDIVIDUALIZATION	Для выполнения этой функции DRM требуется отдельный черный ящик. Иными словами, пакет SDK для формата Windows Media требует обновления системы безопасности.

Этот вызов можно выполнить только на устройстве, поддерживающем Windows Media DRM 10 для переносимых устройств. Необходимо указать по крайней мере один пороговый параметр.

Требования

Требование	Значение
Заголовок	WMDRMDeviceApp.h (также требуется Wmdrmdeviceapp_i.c, созданный из WMDRMDeviceApp.idl)
Библиотека	Mssachlp.lib

См. также раздел

Обработка защищенного содержимого в приложении
Интерфейс IWMDMProgress3
Интерфейс IWMDRMDeviceApp

Поделиться через