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

Метод IWMDRMDeviceApp::SynchronizeLicenses

  • Статья

Метод 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