Método ISCPSecureQuery::ExamineData (mswmdm.h)
O método ExamineData determina os direitos e a responsabilidade pelo conteúdo examinando os dados que o Windows Media Gerenciador de Dispositivos passa para esse método.
Sintaxe
HRESULT ExamineData(
[in] UINT fuFlags,
[in] LPWSTR pwszExtension,
[in] BYTE *pData,
[in] DWORD dwSize,
[in, out] BYTE [8] abMac
);
Parâmetros
[in] fuFlags
Sinalizadores que descrevem os dados oferecidos ao provedor de conteúdo seguro para tomar decisões. Os sinalizadores a seguir podem estar presentes.
| Sinalizador | Descrição |
|---|---|
| WMDM_SCP_EXAMINE_DATA | O parâmetro pData aponta para os dados a serem examinados. |
[in] pwszExtension
Ponteiro para a extensão de nome de arquivo a ser examinada se o provedor de conteúdo seguro solicitar uma extensão na chamada GetDataDemands .
[in] pData
Ponteiro para os dados no início do arquivo a ser examinado. Esse parâmetro deve ser incluído no código de autenticação de mensagem de entrada e deve ser criptografado.
[in] dwSize
DWORD que contém o comprimento, em bytes, dos dados a serem examinados. Esse parâmetro deve ser incluído no código de autenticação de mensagem de entrada.
[in, out] abMac
Matriz de oito bytes que contém o código de autenticação de mensagem para os dados de parâmetro desse método. (WMDM_MAC_LENGTH é definido como 8.)
Retornar valor
O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.
| Código de retorno | Descrição |
|---|---|
|
O método foi bem-sucedido. O provedor de conteúdo seguro é responsável por esse conteúdo. |
|
Esse método foi chamado fora de sequência. GetDataDemands deve ser chamado primeiro. |
|
O código de autenticação de mensagem não é válido. |
|
Os Gerenciador de Dispositivos do Windows Media devem chamar esse método novamente com outro pacote de dados. O tamanho do pacote é determinado pelo parâmetro pdwMinExamineData no método GetDataDemands . |
|
O provedor de conteúdo seguro não é responsável por esse conteúdo. Encerre a interação com o provedor de conteúdo seguro. |
|
Um parâmetro é inválido ou é um ponteiro NULL . |
|
Ocorreu um erro não especificado. |
Comentários
Esse método é chamado após o método GetDataDemands . O provedor de conteúdo seguro usa as informações passadas neste método para determinar se ele é responsável pelo conteúdo. O parâmetro fuFlags é consultado para determinar quais dados foram apresentados para exame. O parâmetro pData aponta para o início dos dados de direitos e responsabilidade. O parâmetro dwSize contém o comprimento, em bytes, dos dados de direitos e responsabilidade.
Se o sinalizador WMDM_SCP_EXAMINE_DATA estiver definido, o parâmetro pDataBuffer conterá dwDataLength de bytes para o provedor de conteúdo seguro examinar.
Se esse método não retornar S_OK ou WMDM_E_MOREDATA, o Gerenciador de Dispositivos do Windows Media não fará mais chamadas para esse provedor de conteúdo seguro.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | mswmdm.h |
| Biblioteca | Mssachlp.lib |