Метод IWMDRMSecurity::P erformSecurityUpdate
[Функция, связанная с этой страницей, Windows Media Format 11 SDK, является устаревшей функцией. Он был заменен средством чтения исходного кода и модуля записи приемника. Средство чтения исходного кода и модуль записи приемника оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код по возможности использовал средство чтения исходного кода и модуль записи приемника вместо пакета SDK для Windows Media Format 11. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]
Метод PerformSecurityUpdate инициирует обновление системы безопасности подсистемы DRM на локальном компьютере.
Синтаксис
HRESULT PerformSecurityUpdate(
[in] DWORD dwFlags,
[out] IUnknown **ppunkCancelationCookie
);
Параметры
-
dwFlags [in]
-
Параметр update, выраженный в виде одного из следующих флагов.
Flag Описание WMDRM_SECURITY_PERFORM_INDIV Вызывает индивидуализацию компонента DRM, только если версия клиента устарела. WMDRM_SECURITY_PERFORM_REVOCATION_REFRESH Вызывает обновление списков отзыва на клиентском компьютере. WMDRM_SECURITY_PERFORM_FORCE_INDIV Вызывает индивидуализацию компонента DRM, даже если версия клиента обновлена. -
ppunkCancelationCookie [out]
-
Адрес переменной, получающей указатель на объект, который можно использовать для отмены этой операции.
Возвращаемое значение
Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.
| Код возврата | Описание |
|---|---|
|
Метод выполнен успешно. |
Комментарии
Этот метод выполняется асинхронно. Он возвращается сразу после вызова, а затем создает события в зависимости от флага, установленного в параметре dwFlags .
Для индивидуализации (флаг имеет значение WMDRM_SECURITY_PERFORM_INDIV или WMDRM_SECURITY_PERFORM_FORCE_INDIV) создается ряд событий MEWMDRMIndividualizationProgress , за которым следует событие MEWMDRMIndividualizationCompleted после завершения обработки. Значение каждого события MEWMDRMIndividualizationProgress , полученное путем вызова IMFMediaEvent::GetValue , является указателем IUnknown . Вы можете вызвать метод QueryInterface полученного интерфейса IUnknown , чтобы получить экземпляр интерфейса IWMDRMIndividualizationStatus .
Для обновления списков отзыва (флаг WMDRM_SECURITY_PERFORM_REVOCATION_REFRESH) по завершении обработки создается событие MEWMDRMREvocationDownloadCompleted .
Примечание
Когда PerformSecurityUpdate завершает индивидуализацию, единственными существующими объектами, которые будут отражать новое индивидуализированное состояние, являются объекты, наследуемые от IWMDRMSecurity. Все остальные существующие объекты не будут обновлены. Необходимо освободить и повторно создать все другие объекты, чтобы они отражали новое индивидуализированное состояние.
Дополнительные сведения об использовании асинхронных методов расширенных API клиента DRM Windows Media см. в разделе Использование модели событий Media Foundation.
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
| Библиотека |
|