Compartir a través de

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

  • Artículo

El método ExamineData determina los derechos y la responsabilidad del contenido examinando los datos que Windows Media Administrador de dispositivos pasa a este método.

Sintaxis

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

Parámetros

[in] fuFlags

Marcas que describen los datos ofrecidos al proveedor de contenido seguro para tomar decisiones. Las marcas siguientes pueden estar presentes.

Marca Descripción
WMDM_SCP_EXAMINE_DATA El parámetro pData apunta a los datos que se van a examinar.

[in] pwszExtension

Puntero a la extensión de nombre de archivo que se va a examinar si el proveedor de contenido seguro solicita una extensión en la llamada GetDataDemands .

[in] pData

Puntero a los datos al principio del archivo que se va a examinar. Este parámetro debe incluirse en el código de autenticación del mensaje de entrada y debe cifrarse.

[in] dwSize

DWORD que contiene la longitud, en bytes, de los datos que se van a examinar. Este parámetro debe incluirse en el código de autenticación del mensaje de entrada.

[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

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta. El proveedor de contenido seguro es responsable de este contenido.
WMDM_E_CALL_OUT_OF_SEQUENCE
 Este método se ha llamado fuera de secuencia. Primero se debe llamar a GetDataDemands.
WMDM_E_MAC_CHECK_FAILED
 El código de autenticación del mensaje no es válido.
WMDM_E_MOREDATA
 Windows Media Administrador de dispositivos debe llamar de nuevo a este método con otro paquete de datos. El tamaño del paquete viene determinado por el parámetro pdwMinExamineData en el método GetDataDemands .
S_FALSE
 El proveedor de contenido seguro no es responsable de este contenido. Finalice la interacción con el proveedor de contenido seguro.
E_INVALIDARG
 Un parámetro no es válido o es un puntero NULL .
E_FAIL
 Se ha producido un error no especificado.

Comentarios

Se llama a este método después del método GetDataDemands . El proveedor de contenido seguro usa la información pasada en este método para determinar si es responsable del contenido. Se consulta el parámetro fuFlags para determinar qué datos se han presentado para su examen. El parámetro pData apunta al principio de los derechos y los datos de responsabilidad. El parámetro dwSize contiene la longitud, en bytes, de los derechos y los datos de responsabilidad.

Si se establece la marca WMDM_SCP_EXAMINE_DATA, el parámetro pDataBuffer contiene dwDataLength de bytes para que se examine el proveedor de contenido seguro.

Si este método no devuelve S_OK o WMDM_E_MOREDATA, 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