Метод IWMDRMLicenseQuery::QueryActionAllowed
[Функция, связанная с этой страницей, Windows Media Format 11 SDK, является устаревшей функцией. Она была заменена средствами чтения источника и модуля записи приемников. Средство чтения источника и модуль записи приемников оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде средство чтения исходного кода и модуль записи приемников вместо пакета SDK для Windows Media Format 11, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]
Метод QueryActionAllowed выполняет запрос к локальному хранилищу лицензий, чтобы получить состояние лицензии для одного или нескольких действий DRM, которые применяются к указанному идентификатору ключа.
Синтаксис
HRESULT QueryActionAllowed(
[in] BSTR bstrKID,
[in] BSTR bstrMinReqIndivVersion,
[in] DWORD cActionsToQuery,
[in] BSTR rgbstrActionsToQuery[],
[out] DWORD rgdwQueryResult[]
);
Параметры
-
bstrKID [in]
-
Идентификатор ключа, для которого выполняется запрос. Будут оцениваться только лицензии, которые применяются к этому идентификатору ключа.
-
bstrMinReqIndivVersion [in]
-
Минимальная версия безопасности, указанная в заголовке ASF-файла. Этот параметр является необязательным. Передайте значение NULL , чтобы выполнить запрос без этих сведений.
-
cActionsToQuery [in]
-
Количество действий, для которых выполняется запрос. Это значение должно быть равно количеству элементов в массивах, передаваемых для параметров rgbstrActionsToQuery и rgdwQueryResult .
-
rgbstrActionsToQuery[] [in]
-
Массив с одним или несколькими правами, для которых выполняется запрос. Этот массив должен содержать столько элементов, сколько указано в параметре cActionsToQuery. Для каждого элемента должна быть задана одна из следующих констант:
Константа Описание g_wszWMDRM_ActionAllowed_Playback Включите в запрос на право воспроизведения содержимого. g_wszWMDRM_ActionAllowed_Copy Включите в запрос на право копирования содержимого на внешние устройства или носители. g_wszWMDRM_ActionAllowed_PlaylistBurn Включите в запрос на право копирования содержимого на компакт-диск как часть списка воспроизведения. g_wszWMDRM_ActionAllowed_CreateThumbnailImage Включите в запрос для получения права на создание эскиза изображения на основе содержимого. g_wszWMDRM_ActionAllowed_CopyToCD Включите в запрос на право копирования содержимого на компакт-диск. -
rgdwQueryResult[] [out]
-
Массив из одной или нескольких переменных DWORD, получающих результаты запроса для прав, заданных rgbstrActionsToQuery. Если действие разрешено, соответствующий элемент задается равным нулю. Если действие запрещено, элементу присваивается одно или несколько значений перечисления DRM_ACTION_ALLOWED_QUERY_RESULTS , объединенных с помощью побитовой операции OR. Этот массив должен содержать столько элементов, сколько указано в параметре cActionsToQuery.
Возвращаемое значение
Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.
| Код возврата | Описание |
|---|---|
|
Метод выполнен успешно. |
Комментарии
При запросе прав на воспроизведение и копирование вы получите более точные результаты, сначала задав параметры среды. Используйте метод SetActionAllowedQueryParams , чтобы задать параметры среды. Результаты запросов для права на выгорание не затрагиваются параметрами среды; вы можете безопасно использовать значения по умолчанию.
Результаты, возвращаемые методом QueryActionAllowed , объединяются из нуля или более лицензий в локальном хранилище лицензий. Метод может выполнять поиск не во всех лицензиях, которые применяются к идентификатору ключа, если он обнаруживает включенный результат.
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
| Библиотека |
|