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

Метод ISCPSecureQuery::ExamineData (mswmdm.h)

  • Статья

Метод ExamineData определяет права и ответственность за содержимое путем проверки данных, которые windows Media диспетчер устройств передает этому методу.

Синтаксис

HRESULT ExamineData(
  [in]      UINT     fuFlags,
  [in]      LPWSTR   pwszExtension,
  [in]      BYTE     *pData,
  [in]      DWORD    dwSize,
  [in, out] BYTE [8] abMac
);

Параметры

[in] fuFlags

Флаги, описывающие данные, предлагаемые поставщику защищенного содержимого для принятия решений. Могут присутствовать следующие флаги.

Flag Описание
WMDM_SCP_EXAMINE_DATA Параметр pData указывает на проверяемые данные.

[in] pwszExtension

Указатель на расширение имени файла для проверки, если поставщик защищенного содержимого запрашивает расширение в вызове GetDataDemands .

[in] pData

Указатель на данные в начале проверяемого файла. Этот параметр должен быть включен в код проверки подлинности входного сообщения и должен быть зашифрован.

[in] dwSize

Значение DWORD , содержащее длину проверяемых данных (в байтах). Этот параметр должен быть включен в код проверки подлинности входного сообщения.

[in, out] abMac

Массив из восьми байтов, содержащий код проверки подлинности сообщения для данных параметров этого метода. (WMDM_MAC_LENGTH определяется как 8.)

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

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

Код возврата Описание
S_OK
 Метод выполнен успешно. За это содержимое отвечает поставщик безопасного содержимого.
WMDM_E_CALL_OUT_OF_SEQUENCE
 Этот метод был вызван из последовательности. Сначала необходимо вызвать GetDataDemands.
WMDM_E_MAC_CHECK_FAILED
 Недопустимый код проверки подлинности сообщения.
WMDM_E_MOREDATA
 Windows Media диспетчер устройств должны снова вызвать этот метод с другим пакетом данных. Размер пакета определяется параметром pdwMinExamineData в методе GetDataDemands .
S_FALSE
 Поставщик безопасного содержимого не несет ответственности за это содержимое. Завершите взаимодействие с поставщиком безопасного содержимого.
E_INVALIDARG
 Недопустимый параметр или является указателем NULL .
E_FAIL
 Произошла неизвестная ошибка.

Комментарии

Этот метод вызывается после метода GetDataDemands . Поставщик безопасного содержимого использует данные, передаваемые в этом методе, чтобы определить, отвечает ли он за содержимое. Чтобы определить, какие данные были представлены для изучения, обратитесь к параметру fuFlags . Параметр pData указывает на начало данных о правах и обязанностях. Параметр dwSize содержит длину (в байтах) данных о правах и обязанностях.

Если установлен флаг WMDM_SCP_EXAMINE_DATA, то параметр pDataBuffer содержит dwDataLength байтов для проверки поставщика безопасного содержимого.

Если этот метод не возвращает S_OK или WMDM_E_MOREDATA, диспетчер устройств Windows Media не выполняет дальнейшие вызовы к этому поставщику защищенного содержимого.

Требования

Требование Значение
Целевая платформа Windows
Header mswmdm.h
Библиотека Mssachlp.lib

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

Интерфейс ISCPSecureQuery