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

Метод IWMDRMNetTransmitter::GetRootLicenseResponse

  • Статья

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

Метод GetRootLicenseResponse создает ответное сообщение корневой лицензии.

Синтаксис

HRESULT GetRootLicenseResponse(
  [in]  BSTR  bstrKID,
  [out] BYTE  **ppbLicenseResponse,
  [out] DWORD *pcbLicenseResponse
);

Параметры

bstrKID [in]

Идентификатор ключа в кодировке Base64, который будет использоваться для новой корневой лицензии. Идентификатор ключа должен быть случайным образом сформированным значением GUID.

ppbLicenseResponse [out]

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

pcbLicenseResponse [out]

Адрес переменной, получающей размер ответа лицензии в байтах.

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

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

Код возврата Описание
NS_E_DRM_RIV_TOO_SMALL
 Требуется обновленный список отзыва содержимого.
S_OK
 Метод выполнен успешно.

Комментарии

Созданная корневая лицензия создается на основе сведений из данных запроса лицензии, которые обрабатываются для интерфейса путем вызова SetLicenseChallenge.

Корневая лицензия используется при создании конечных лицензий, что осуществляется путем вызова метода GetLeafLicenseResponse . Интерфейс IWMDRMNetTransmitter хранит копию корневой лицензии для этого использования.

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

Требования

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

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

Интерфейс IWMDRMNetTransmitter