Método ISCPSecureQuery::GetDataDemands (mswmdm.h)
O método GetDataDemands relata quais dados o provedor de conteúdo seguro precisa para determinar os direitos e a responsabilidade por um conteúdo especificado.
Sintaxe
HRESULT GetDataDemands(
[out] UINT *pfuFlags,
[out] DWORD *pdwMinRightsData,
[out] DWORD *pdwMinExamineData,
[out] DWORD *pdwMinDecideData,
[in, out] BYTE [8] abMac
);
Parâmetros
[out] pfuFlags
Sinalizadores que descrevem os dados exigidos pelo provedor de conteúdo seguro para tomar decisões. Esse parâmetro está incluído no código de autenticação de mensagem de saída. Pelo menos um dos sinalizadores a seguir deve ser usado.
| Sinalizador | Descrição |
|---|---|
| WMDM_SCP_RIGHTS_DATA | O provedor de conteúdo seguro precisa de dados para determinar os direitos do conteúdo. |
| WMDM_SCP_EXAMINE_DATA | O provedor de conteúdo seguro precisa de dados para determinar se ele é responsável pelo conteúdo. |
| WMDM_SCP_DECIDE_DATA | O provedor de conteúdo seguro precisa de dados para determinar se o conteúdo deve ser baixado. |
| WMDM_SCP_EXAMINE_EXTENSION | O provedor de conteúdo seguro precisa examinar a extensão de nome de arquivo para determinar se o conteúdo deve ser baixado. |
| WMDM_SCP_PROTECTED_OUTPUT | O provedor de conteúdo seguro precisa de uma saída protegida. |
| WMDM_SCP_UNPROTECTED_OUTPUT | O provedor de conteúdo seguro precisa de saída desprotegida. |
[out] pdwMinRightsData
Ponteiro para um DWORD que especifica a quantidade mínima de dados necessária para determinar direitos para esse conteúdo. Esse parâmetro está incluído no código de autenticação de mensagem de saída.
[out] pdwMinExamineData
Ponteiro para um DWORD que contém o número mínimo de bytes de dados que o provedor de conteúdo seguro precisa para determinar se ele é responsável pelo conteúdo. Esse parâmetro está incluído no código de autenticação de mensagem de saída.
[out] pdwMinDecideData
Ponteiro para um DWORD que contém o número mínimo de bytes de dados que o provedor de conteúdo seguro precisa para determinar se o conteúdo deve ser baixado. Esse parâmetro está incluído no código de autenticação de mensagem de saída.
[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
Se o método for bem-sucedido, retornará S_OK. Se falhar, retornará um código de erro HRESULT .
| Código de retorno | Descrição |
|---|---|
|
O código de autenticação de mensagem não é válido. |
|
Um parâmetro é um ponteiro nulo ou inválido. |
|
Ocorreu um erro não especificado. |
Comentários
Esse método deve ser chamado antes que qualquer um dos outros métodos de ISCPSecureQuery seja chamado.
Esse método é chamado depois que todas as trocas de certificados tiverem sido concluídas com êxito. O provedor de conteúdo seguro preenche os parâmetros com os sinalizadores e dados que descrevem seus requisitos para tomar decisões sobre o conteúdo.
Se o provedor de conteúdo seguro definir o sinalizador WMDM_SCP_RIGHTS_DATA, o Windows Media Gerenciador de Dispositivos enviará a quantidade de dados especificada em pdwMinRightsData chamando ISCPSecureQuery::GetRights.
Se o provedor de conteúdo seguro definir o sinalizador WMDM_SCP_EXAMINE_DATA, o Windows Media Gerenciador de Dispositivos enviará a quantidade de dados especificada em pdwMinExamineData chamando ISCPSecureQuery::ExamineData.
Se o provedor de conteúdo seguro definir o sinalizador WMDM_SCP_DECIDE_DATA, o Windows Media Gerenciador de Dispositivos enviará a quantidade de dados especificada em pdwMinDecideData chamando ISCPSecureQuery::MakeDecision.
Se nenhum sinalizador de análise estiver definido, o Windows Media Gerenciador de Dispositivos não fará mais chamadas. Se nenhum sinalizador de decisão estiver definido, o Windows Media Gerenciador de Dispositivos ainda chamará ISCPSecureQuery::ExamineData.
Se esse método não retornar S_OK, o Windows Media Gerenciador de Dispositivos 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 |