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

Artículo
02/29/2024

El método GetRightsOnClearChannel recupera información de derechos para el contenido actual en un canal claro.

Sintaxis

HRESULT GetRightsOnClearChannel(
  [in]  BYTE                *pData,
  [in]  DWORD               dwSize,
  [in]  BYTE                *pbSPSessionKey,
  [in]  DWORD               dwSessionKeyLen,
  [in]  IMDSPStorageGlobals *pStgGlobals,
  [in]  IWMDMProgress3      *pProgressCallback,
  [out] PWMDMRIGHTS         *ppRights,
  [out] UINT                *pnRightsCount
);

Parámetros

[in] pData

Puntero al objeto de datos.

[in] dwSize

Número de bytes de datos en el búfer pData .

[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] pStgGlobals

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

[in] pProgressCallback

Puntero a una interfaz IWMDMProgress3 .

[out] ppRights

Puntero a una matriz de estructuras WMDMRIGHTS que contienen la información de derechos de este objeto. Este método asigna la matriz y se debe liberar mediante CoTaskMemFree.

[out] pnRightsCount

Número de estructuras WMDMRIGHTS en la matriz ppRights .

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. ISCPSecureQuery::GetDataDemands y, a continuación, se debe llamar a ISCPSecureQuery::ExamineData en ese orden.
WMDM_E_MAC_CHECK_FAILED	El código de autenticación del mensaje no es válido.
WMDM_E_NORIGHTS	El autor de la llamada no tiene los derechos necesarios para realizar la operación 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 ISCPSecureQuery::GetRights , salvo que los parámetros pasados a este método no están cifrados. Por lo tanto, este método es más eficaz.