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