Método ISCPSecureQuery3::MakeDecisionOnClearChannel (mswmdm.h)

El método MakeDecisionOnClearChannel determina si se permite el acceso al contenido en un canal claro. Si se permite el acceso, este método devuelve la interfaz usada para acceder al contenido.

Sintaxis

HRESULT MakeDecisionOnClearChannel(
  [in]      UINT                fuFlags,
  [in]      BYTE                *pData,
  [in]      DWORD               dwSize,
  [in]      DWORD               dwAppSec,
  [in]      BYTE                *pbSPSessionKey,
  [in]      DWORD               dwSessionKeyLen,
  [in]      IMDSPStorageGlobals *pStorageGlobals,
  [in]      IWMDMProgress3      *pProgressCallback,
  [in]      BYTE                *pAppCertApp,
  [in]      DWORD               dwAppCertAppLen,
  [in]      BYTE                *pAppCertSP,
  [in]      DWORD               dwAppCertSPLen,
  [in, out] LPWSTR              *pszRevocationURL,
  [in, out] DWORD               *pdwRevocationURLLen,
  [out]     DWORD               *pdwRevocationBitFlag,
  [in, out] ULONGLONG           *pqwFileSize,
  [in]      IUnknown            *pUnknown,
  [out]     ISCPSecureExchange  **ppExchange
);

Parámetros

[in] fuFlags

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

Marca	Descripción
WMDM_SCP_DECIDE_DATA	El parámetro pData apunta a los datos que se van a examinar.
WMDM_MODE_TRANSFER_PROTECTED	Los datos del objeto de salida de la interfaz ISCPSecureExchange deben estar protegidos. Si Windows Media Administrador de dispositivos establece ninguna o ambas marcas de modo, la administración de derechos digitales (DRM) decide si los datos del objeto de salida de la interfaz ISCPSecureExchange deben estar protegidos o no protegidos.
WMDM_MODE_TRANSFER_UNPROTECTED	Los datos del objeto de salida de la interfaz ISCPSecureExchange deben estar desprotegidos. Si Windows Media Administrador de dispositivos establece ninguna o ambas marcas de modo, la administración de derechos digitales (DRM) decide si los datos del objeto de salida de la interfaz ISCPSecureExchange deben estar protegidos o no protegidos.

[in] pData

Puntero a un objeto de datos que contiene los datos que se van a examinar.

[in] dwSize

DWORD que contiene la longitud, en bytes, de los datos que se van a examinar.

[in] dwAppSec

DWORD que indica el nivel actual de seguridad de Windows Media Administrador de dispositivos. Este es el menor de los niveles de seguridad actuales de la aplicación y el proveedor de servicios de destino.

[in] pbSPSessionKey

Puntero a una matriz de bytes que contiene la clave de sesión para proteger la comunicación con el proveedor de servicios al que apunta pStgGlobals .

[in] dwSessionKeyLen

Longitud de la matriz de bytes a la que apunta pbSPSessionKey .

[in] pStorageGlobals

Puntero a la interfaz IWMDMStorageGlobals en el almacenamiento raíz del medio o dispositivo hacia o desde el que se transfiere el archivo.

[in] pProgressCallback

Puntero a un objeto de devolución de llamada de progreso.

[in] pAppCertApp

Puntero a un certificado de aplicación del objeto de aplicación.

[in] dwAppCertAppLen

DWORD que contiene la longitud, en bytes, del certificado de aplicación.

[in] pAppCertSP

Puntero al certificado de aplicación del objeto del proveedor de servicios.

[in] dwAppCertSPLen

DWORD que contiene la longitud, en bytes, del certificado de aplicación.

[in, out] pszRevocationURL

Puntero a un búfer para contener la dirección URL de revocación.

[in, out] pdwRevocationURLLen

Puntero a un DWORD que contiene el tamaño del búfer rpszRevocationURL en bytes.

[out] pdwRevocationBitFlag

Puntero a un DWORD que contiene la marca de bits de revocación. El valor de marca será cero o uno o varios de los siguientes nombres de marca combinados mediante un OR bit a bit.

Valor	Descripción
WMDM_WMDM_REVOKED	Windows Media Administrador de dispositivos se ha revocado.
WMDM_APP_REVOKED	La aplicación se ha revocado y debe actualizarse antes de que se pueda transferir cualquier contenido protegido con DRM.
WMDM_SP_REVOKED	El proveedor de servicios se ha revocado y debe actualizarse antes de que cualquier contenido protegido con DRM se pueda transferir a él.
WMDM_SCP_REVOKED	El proveedor de contenido se ha revocado y debe actualizarse antes de que se pueda transferir cualquier contenido protegido con DRM.

[in, out] pqwFileSize

Puntero a un QWORD que contiene el tamaño del archivo. El proveedor de contenido es responsable de actualizar este valor o establecerlo en cero si el tamaño del archivo de destino no se puede determinar en este momento.

[in] pUnknown

Puntero a una interfaz desconocida desde la aplicación.

[out] ppExchange

Puntero a un objeto de intercambio que recibe la interfaz de intercambio.

Valor devuelto

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

Código devuelto	Descripción
WMDM_E_CALL_OUT_OF_SEQUENCE	Este método se ha llamado fuera de secuencia.
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 pdwMinDecisionData en el método ISCPSecureQuery::GetDataDemands .
S_FALSE	El autor de la llamada no tiene los derechos necesarios para realizar la transferencia solicitada.
E_INVALIDARG	Un parámetro no es válido o es un puntero NULL .
E_FAIL	Se ha producido un error no especificado.

Comentarios

Este método es idéntico a ISCPSecureQuery2::MakeDecision2 , salvo que los parámetros pasados a este método no están cifrados. Por lo tanto, este método es más eficaz.

Requisitos

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

Consulte también

ISCPSecureQuery2::MakeDecision2

Interfaz ISCPSecureQuery3