Метод IWMDRMSecurity::GetMachineCertificate

Статья
06/21/2023

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

Метод GetMachineCertificate извлекает сертификат компьютера подсистемы DRM на клиентском компьютере.

Синтаксис

HRESULT GetMachineCertificate(
  [in]      DWORD dwCertificateType,
  [out]     BYTE  rgbVersion[4],
  [out]     BYTE  **ppbCertificate,
  [in, out] DWORD *pcbCertificate
);

Параметры

dwCertificateType [in]

Тип извлекаемого сертификата. Задайте для одного из значений в следующей таблице.

Значение	Описание
WMDRM_CERTIFICATE_TYPE_V1	Сертификат будет получен в формате, используемом устаревшими компонентами.
WMDRM_CERTIFICATE_TYPE_V2	Сертификат будет получен в формате, используемом компонентами Windows Vista.

rgbVersion[4] [out]

Массив из четырех байтов, указывающий версию подсистемы DRM на клиентском компьютере.

ppbCertificate [out]

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

pcbCertificate [in, out]

Размер сертификата в байтах. Если ppbCertificate имеет значение NULL, это значение будет равно размеру сертификата. Если ppbCertificate не равно NULL, это значение должно быть равно размеру буфера.

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.

Требования

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

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

Интерфейс IWMDRMSecurity

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