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


Метод IWMDRMSecurity::GetContentEnablersForRevocations

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

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

Синтаксис

HRESULT GetContentEnablersForRevocations(
  [in]      BYTE              **rgpbCerts,
  [in]      DWORD             *rgpdwCertSizes,
  [in]      GUID              **rgpguidCerts,
  [in]      DWORD             cCerts,
  [in]      HRESULT           hResultHint,
  [out]     IMFContentEnabler **prgContentEnablers,
  [in, out] DWORD             *pcContentEnablers
);

Параметры

rgpbCerts [in]

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

rgpdwCertSizes [in]

Массив, содержащий размеры сертификатов в массиве rgpbCerts . Количество элементов в массиве должно быть указано cCerts.

rgpguidCerts [in]

Массив, содержащий типы сертификатов в массиве rgpbCerts . Количество элементов в массиве должно быть указано cCerts. Для каждого элемента массива используйте одно из следующих значений.

Константы GUID Описание
WMDRM_REVOCATIONTYPE_APP Указывает сертификат приложения.
WMDRM_REVOCATIONTYPE_DEVICE Указывает сертификат устройства.
WMDRM_REVOCATIONTYPE_CARDEA Указывает сертификат Windows Media DRM для сетевых устройств.

cCerts [in]

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

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