Compartir a través de

Método ISCPSecureQuery::GetDataDemands (mswmdm.h)

  • Artículo

El método GetDataDemands informa de qué datos necesita el proveedor de contenido seguro para determinar los derechos y la responsabilidad de un fragmento de contenido especificado.

Sintaxis

HRESULT GetDataDemands(
  [out]     UINT     *pfuFlags,
  [out]     DWORD    *pdwMinRightsData,
  [out]     DWORD    *pdwMinExamineData,
  [out]     DWORD    *pdwMinDecideData,
  [in, out] BYTE [8] abMac
);

Parámetros

[out] pfuFlags

Marcas que describen los datos requeridos por el proveedor de contenido seguro para tomar decisiones. Este parámetro se incluye en el código de autenticación del mensaje de salida. Se debe usar al menos una de las marcas siguientes.

Marca Descripción
WMDM_SCP_RIGHTS_DATA El proveedor de contenido seguro necesita datos para determinar los derechos del contenido.
WMDM_SCP_EXAMINE_DATA El proveedor de contenido seguro necesita datos para determinar si es responsable del contenido.
WMDM_SCP_DECIDE_DATA El proveedor de contenido seguro necesita datos para determinar si se va a permitir que se descargue el contenido.
WMDM_SCP_EXAMINE_EXTENSION El proveedor de contenido seguro debe examinar la extensión de nombre de archivo para determinar si se va a permitir que se descargue el contenido.
WMDM_SCP_PROTECTED_OUTPUT El proveedor de contenido seguro necesita salida protegida.
WMDM_SCP_UNPROTECTED_OUTPUT El proveedor de contenido seguro necesita una salida desprotegida.

[out] pdwMinRightsData

Puntero a un DWORD que especifica la cantidad mínima de datos necesarios para determinar los derechos de este contenido. Este parámetro se incluye en el código de autenticación del mensaje de salida.

[out] pdwMinExamineData

Puntero a un DWORD que contiene el número mínimo de bytes de datos que el proveedor de contenido seguro necesita para determinar si es responsable del contenido. Este parámetro se incluye en el código de autenticación del mensaje de salida.

[out] pdwMinDecideData

Puntero a un DWORD que contiene el número mínimo de bytes de datos que el proveedor de contenido seguro necesita para determinar si se va a permitir que se descargue el contenido. Este parámetro se incluye en el código de autenticación del mensaje de salida.

[in, out] abMac

Matriz de ocho bytes que contiene el código de autenticación de mensajes para los datos de parámetros de este método. (WMDM_MAC_LENGTH se define como 8).

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, devuelve un código de error HRESULT .

Código devuelto Descripción
WMDM_E_MAC_CHECK_FAILED
 El código de autenticación del mensaje no es válido.
E_INVALIDARG
 Un parámetro es un puntero no válido o NULL .
E_FAIL
 Se ha producido un error no especificado.

Comentarios

Se debe llamar a este método antes de llamar a cualquiera de los otros métodos de ISCPSecureQuery .

Se llama a este método después de que se hayan completado correctamente los intercambios de certificados. El proveedor de contenido seguro rellena los parámetros con las marcas y los datos que describen sus requisitos para tomar decisiones sobre el contenido.

Si el proveedor de contenido seguro establece la marca WMDM_SCP_RIGHTS_DATA, Windows Media Administrador de dispositivos envía la cantidad de datos especificados en pdwMinRightsData mediante una llamada a ISCPSecureQuery::GetRights.

Si el proveedor de contenido seguro establece la marca WMDM_SCP_EXAMINE_DATA, Windows Media Administrador de dispositivos envía la cantidad de datos especificados en pdwMinExamineData mediante una llamada a ISCPSecureQuery::ExamineData.

Si el proveedor de contenido seguro establece la marca WMDM_SCP_DECIDE_DATA, Windows Media Administrador de dispositivos envía la cantidad de datos especificados en pdwMinDecideData mediante una llamada a ISCPSecureQuery::MakeDecision.

Si no se establecen marcas de examen, Windows Media Administrador de dispositivos no realiza más llamadas. Si no se establecen marcas de decisión, Windows Media Administrador de dispositivos todavía llama a ISCPSecureQuery::ExamineData.

Si este método no devuelve S_OK, Windows Media Administrador de dispositivos no realiza ninguna llamada adicional a este proveedor de contenido seguro.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado mswmdm.h
Library Mssachlp.lib

Consulte también

Interfaz ISCPSecureQuery