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


Метод IWMDRMLicenseManagement::CleanLicenseStore

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

Метод CleanLicenseStore удаляет непригодные для использования лицензии из временного хранилища лицензий и дефрагментирует локальное хранилище лицензий для повышения производительности.

Синтаксис

HRESULT CleanLicenseStore(
  [in]  DWORD    dwFlags,
  [out] IUnknown **ppunkCancelationCookie
);

Параметры

dwFlags [in]

Флаги, указывающие используемые параметры очистки хранилища лицензий. Задайте для одной из констант в следующей таблице.

Константа Описание
WMDRM_CLEAN_LICENSE_STORE_SYNC Операция очистки будет выполняться синхронно. Этот метод не возвращается до завершения операции.
WMDRM_CLEAN_LICENSE_STORE_ASYNC Операция очистки будет выполняться асинхронно. Этот метод возвращается немедленно. После завершения операции будет отправлено событие мультимедиа MELicenseStoreCleaned.

ppunkCancelationCookie [out]

Указатель, получающий указатель на интерфейс IUnknown объекта, который идентифицирует этот асинхронный вызов. Этот указатель интерфейса можно использовать для отмены асинхронного вызова путем вызова метода IWMDRMEventGenerator::CancelAsyncOperation .

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

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

Код возврата Описание
S_OK
Метод выполнен успешно.
DRM_E_LICENSENOTFOUND
На клиентском компьютере нет временного хранилища лицензий.

Комментарии

Этот метод выполняется асинхронно. Он возвращается сразу после вызова, а затем создает событие MEWMDRMLicenseStoreCleaned после завершения обработки.

Дополнительные сведения об использовании асинхронных методов расширенных API клиента DRM Windows Media см. в разделе Использование модели событий Media Foundation.

Требования

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

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

Интерфейс IWMDRMLicenseManagement