Метод IWMDRMSecurity::GetContentEnablersFromHashes

  • Статья

[Функция, связанная с этой страницей, Windows Media Format 11 SDK, является устаревшей функцией. Он был заменен средством чтения исходного кода и модуля записи приемника. Средство чтения исходного кода и модуль записи приемника оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код по возможности использовал средство чтения исходного кода и модуль записи приемника вместо пакета SDK для Windows Media Format 11. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]

Метод GetContentEnablersFromHashes извлекает интерфейсы включения содержимого, которые позволяют обновлять компоненты на основе хэшированных сертификатов.

Синтаксис

HRESULT GetContentEnablersFromHashes(
  [in]      BSTR              *rgpbCertHashes,
  [in]      DWORD             cCerts,
  [in]      HRESULT           hResultHint,
  [out]     IMFContentEnabler **prgContentEnablers,
  [in, out] DWORD             *pcContentEnablers
);

Параметры

rgpbCertHashes [in]

Массив хэшей сертификатов для получения средств включения содержимого.

cCerts [in]

Количество сертификатов, для которых требуется извлечь компоненты для включения содержимого. Это количество элементов в массиве rgpbCertHashes .

hResultHint [in]

Возвращаемое значение, полученное из операции, которая завершилась сбоем из-за отозванного сертификата. Если вы не вызываете в ответ на неудачный вызов метода, задайте для значение S_OK.

prgContentEnablers [out]

Массив, получающий адреса только что созданных интерфейсов IMFContentEnabler . Задайте значение NULL , чтобы получить количество средств включения содержимого в параметре pcContentEnablers .

pcContentEnablers [in, out]

Количество элементов в массиве prgContentEnablers . Если prgContentEnablers имеет значение NULL, для этого значения устанавливается количество необходимых средств включения содержимого на выходе.

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

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата Описание
S_OK
 Метод выполнен успешно.

Комментарии

Если вы используете интерфейс IMFContentEnabler для продления отозванных компонентов, необходимо уточнить процесс для пользователя. Это необходимо сделать, так как процесс обновления отправляет информацию с клиентского компьютера на веб-сайт Майкрософт.

При вызове IMFContentEnabler::AutomaticEnable активатор содержимого запускает браузер по умолчанию с адресом службы обновления на веб-сайте Майкрософт. В службу обновления отправляется уникальный идентификатор, определяющий отозванный компонент. Затем служба перенаправляет браузер на веб-страницу, с которой пользователь может скачать и установить новую версию отозванного компонента.

Требования

Требование Значение
Заголовок
Wmdrmsdk.h
Библиотека
Wmdrmsdk.lib

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

Интерфейс IWMDRMSecurity