Метод IWMDRMLicenseManagement::RestoreLicenses
[Функция, связанная с этой страницей, Windows Media Format 11 SDK, является устаревшей функцией. Она была заменена средствами чтения источника и модуля записи приемников. Средство чтения источника и модуль записи приемников оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде средство чтения исходного кода и модуль записи приемников вместо пакета SDK для Windows Media Format 11, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]
Метод RestoreLicenses восстанавливает лицензии из резервной копии лицензий, созданной путем вызова метода BackupLicenses .
Синтаксис
HRESULT RestoreLicenses(
[in] BSTR bstrBackupDirectory,
[in] DWORD dwFlags,
[out] IUnknown **ppunkCancelationCookie
);
Параметры
-
bstrBackupDirectory [in]
-
UNC-путь к расположению, из которого будут восстановлены лицензии.
-
dwFlags [in]
-
Флаги, указывающие используемые параметры восстановления. Единственный поддерживаемый в настоящее время флаг — WMDRM_RESTORE_INDIVIDUALIZE, который при необходимости настраивает метод для выполнения индивидуализации в рамках восстановления.
-
ppunkCancelationCookie [out]
-
Указатель, получающий указатель на интерфейс IUnknown объекта, который идентифицирует этот асинхронный вызов. Этот указатель интерфейса можно использовать для отмены асинхронного вызова путем вызова метода IWMDRMEventGenerator::CancelAsyncOperation .
Возвращаемое значение
Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.
| Код возврата | Описание |
|---|---|
|
Метод выполнен успешно. |
Комментарии
Этот метод выполняется асинхронно. Он возвращается сразу после вызова, а затем создает ряд событий MEWMDRMLicenseRestoreProgress , за которыми следует событие MEWMDRMLicenseRestoreCompleted по завершении обработки. Значение каждого события MEWMDRMLicenseRestoreProgress , полученное путем вызова IMFMediaEvent::GetValue , является указателем IUnknown . Вы можете вызвать метод QueryInterface полученного интерфейса IUnknown , чтобы получить экземпляр интерфейса IWMDRMLicenseBackupRestoreStatus .
Дополнительные сведения об использовании асинхронных методов расширенных API клиента DRM Windows Media см. в статье Использование модели событий Media Foundation.
Резервная копия может быть с локального компьютера или с другого компьютера.
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
| Библиотека |
|