Метод IWMDRMLicenseQuery::QueryLicenseState
[Функция, связанная с этой страницей, Windows Media Format 11 SDK, является устаревшей функцией. Она была заменена средствами чтения источника и модуля записи приемников. Средство чтения источника и модуль записи приемников оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде средство чтения исходного кода и модуль записи приемников вместо пакета SDK для Windows Media Format 11, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]
Метод QueryLicenseState запрашивает в локальном хранилище лицензий сведения о лицензиях, которые применяются к идентификатору ключа для одного или нескольких конкретных прав.
Синтаксис
HRESULT QueryLicenseState(
[in] BSTR bstrKID,
[in] DWORD cActionsToQuery,
[in] BSTR rgbstrActionsToQuery[],
[out] DRM_LICENSE_STATE_DATA rgResultStateData[]
);
Параметры
-
bstrKID [in]
-
Идентификатор ключа, для которого выполняется запрос. Будут оцениваться только лицензии, которые применяются к этому идентификатору ключа.
-
cActionsToQuery [in]
-
Количество действий, для которых выполняется запрос. Это значение должно быть равно количеству элементов в массивах, переданных для параметров rgbstrActionsToQuery и rgResultStateData .
-
rgbstrActionsToQuery[] [in]
-
Массив с одним или несколькими правами, для которых выполняется запрос. Этот массив должен содержать столько элементов, сколько указано в параметре cActionsToQuery. Каждому элементу необходимо задать одну из следующих констант.
Константа Описание g_wszWMDRM_LicenseState_Backup Включите для запроса сведений о праве на резервное копирование и восстановление лицензии. g_wszWMDRM_LicenseState_CollaborativePlay Включите в запрос сведения о праве на предоставление общего доступа к содержимому группе пользователей в рамках сценария совместного воспроизведения. g_wszWMDRM_LicenseState_Copy Включите в запрос сведения о праве на копирование содержимого на внешние устройства или носитель. g_wszWMDRM_LicenseState_CopyToCD Включите в запрос сведения о праве на копирование содержимого на компакт-диск. g_wszWMDRM_LicenseState_CopyToNonSDMIDevice Включите в запрос подробные сведения о праве на копирование содержимого на устройство, которое не поддерживает инициативу безопасного цифрового мультимедиа (SDMI). g_wszWMDRM_LicenseState_CopyToSDMIDevice Включите для запроса сведений о праве на копирование содержимого на устройство, поддерживающее SDMI. g_wszWMDRM_LicenseState_CreateThumbnailImage Включите в запрос сведения о праве на создание эскиза из содержимого. g_wszWMDRM_LicenseState_Playback Включите для запроса сведений о праве на воспроизведение содержимого. g_wszWMDRM_LicenseState_PlaylistBurn Включите в запрос сведений о праве на копирование содержимого на компакт-диск как часть списка воспроизведения. -
rgResultStateData[] [out]
-
Массив из одной или нескольких DRM_LICENSE_STATE_DATA структур, получающих сведения о состоянии лицензии, которые применяются справа в соответствующем элементе параметра rgbstrActionsToQuery .
Возвращаемое значение
Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.
| Код возврата | Описание |
|---|---|
|
Метод выполнен успешно. |
Комментарии
Поиск и оценка всех лицензий, применяемых к указанному идентификатору ключа. Результаты агрегируются, поэтому каждая DRM_LICENSE_STATE_DATA структура может содержать сведения из нескольких лицензий.
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
| Библиотека |
|