Método IWMDMStorage4::GetRightsWithProgress (mswmdm.h)
El método GetRightsWithProgress recupera la información de derechos del objeto de almacenamiento, lo que proporciona un mecanismo de devolución de llamada para supervisar el progreso.
Sintaxis
HRESULT GetRightsWithProgress(
[in] IWMDMProgress3 *pIProgressCallback,
[out] PWMDMRIGHTS *ppRights,
[out] UINT *pnRightsCount
);
Parámetros
[in] pIProgressCallback
Puntero opcional a una interfaz IWMDMProgress3 que windows Media Administrador de dispositivos usar para notificar el progreso a la aplicación.
[out] ppRights
Puntero a una matriz de estructuras WMDMRIGHTS que contienen la información de derechos de objeto de almacenamiento. Windows Media Administrador de dispositivos asigna memoria para esta matriz. Cuando la aplicación que realiza la llamada haya terminado de acceder a esta matriz, la memoria debe liberarse mediante CoTaskMemFree.
[out] pnRightsCount
Puntero al número de estructuras WMDMRIGHTS de la matriz ppRights .
Valor devuelto
El método devuelve un valor HRESULT. Todos los métodos de interfaz de Windows Media Administrador de dispositivos pueden devolver cualquiera de las siguientes clases de códigos de error:
- Códigos de error COM estándar
- Códigos de error de Windows convertidos en valores HRESULT
- Códigos de error de windows Media Administrador de dispositivos
Comentarios
Los derechos de objeto describen los permisos de uso del contenido multimedia digital. Por ejemplo, la estructura WMDMRIGHTS puede contener información sobre cuántas veces se puede reproducir un archivo y quién puede reproducirlo.
Recuperar derechos de un archivo con licencia a veces puede ser una solicitud larga; esta función permite que una solicitud de derechos se realice de forma asincrónica.
El proveedor de contenido seguro puede generar notificaciones de eventos en la devolución de llamada pIProgressCallback además de las notificaciones de progreso. Algunos ejemplos de estos eventos incluyen la adquisición de un reloj seguro, la inicialización de DRM, etc. Estos eventos se describen en IWMDMProgress3::P rogress3.
Este método es idéntico a IWMDMStorage::GetRights, salvo que devuelve el progreso y no proporciona un MAC para la comprobación de parámetros.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | mswmdm.h |
| Library | Mssachlp.lib |