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

Метод IWMDMStorage4::GetRightsWithProgress (mswmdm.h)

  • Статья

Метод GetRightsWithProgress извлекает сведения о правах для объекта хранилища, предоставляя механизм обратного вызова для мониторинга хода выполнения.

Синтаксис

HRESULT GetRightsWithProgress(
  [in]  IWMDMProgress3 *pIProgressCallback,
  [out] PWMDMRIGHTS    *ppRights,
  [out] UINT           *pnRightsCount
);

Параметры

[in] pIProgressCallback

Необязательный указатель на интерфейс IWMDMProgress3, используемый windows Media диспетчер устройств для передачи отчета о ходе выполнения в приложение.

[out] ppRights

Указатель на массив структур WMDMRIGHTS , содержащих сведения о правах объекта хранилища. Память для этого массива выделяется диспетчер устройств Windows Media. Когда вызывающее приложение завершит доступ к этому массиву, память должна быть освобождена с помощью CoTaskMemFree.

[out] pnRightsCount

Указатель на количество структур WMDMRIGHTS в массиве ppRights .

Возвращаемое значение

Метод возвращает HRESULT. Все методы интерфейса в Windows Media диспетчер устройств могут возвращать любой из следующих классов кодов ошибок:

  • Стандартные коды ошибок COM
  • Коды ошибок Windows, преобразованные в значения HRESULT
  • Коды ошибок диспетчер устройств Windows Media
Подробный список возможных кодов ошибок см. в разделе Коды ошибок.

Комментарии

Права объектов описывают разрешения на использование цифрового мультимедийного содержимого. Например, структура WMDMRIGHTS может содержать сведения о том, сколько раз можно воспроизвести файл и кто может его воспроизвести.

Получение прав из лицензионного файла иногда может быть длительным запросом; Эта функция позволяет выполнять запрос прав асинхронно.

Поставщик безопасного содержимого может создавать уведомления о событиях при обратном вызове pIProgressCallback в дополнение к уведомлениям о ходе выполнения. Примерами таких событий являются получение безопасных часов, инициализация DRM и т. д. Эти события описаны в разделе IWMDMProgress3::P rogress3.

Этот метод идентичен IWMDMStorage::GetRights, за исключением того, что он возвращает ход выполнения и не предоставляет MAC для проверки параметров.

Требования

Требование Значение
Целевая платформа Windows
Header mswmdm.h
Библиотека Mssachlp.lib

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

Интерфейс IWMDMStorage4