Método IMDSPStorage::GetRights (mswmdm.h)

  • Artículo

El método GetRights recupera la información de derechos de un objeto .

Sintaxis

HRESULT GetRights(
  [out]     PWMDMRIGHTS *ppRights,
  [out]     UINT        *pnRightsCount,
  [in, out] BYTE [8]    abMac
);

Parámetros

[out] ppRights

Puntero a una matriz de estructuras WMDMRIGHTS que contienen la información de derechos de objeto de almacenamiento. Este parámetro se incluye en el código de autenticación del mensaje de salida.

[out] pnRightsCount

Puntero al número de estructuras WMDMRIGHTS de la matriz ppRights . 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

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
Para obtener una lista extensa de posibles códigos de error, consulte Códigos de error.

Comentarios

Los derechos de objeto describen los permisos de uso del contenido multimedia. Por ejemplo, la estructura WMDMRIGHTS puede contener información sobre cuántas veces se puede reproducir un archivo y quién puede reproducirlo.

La matriz ppRights se asigna mediante este método y la aplicación debe liberarla mediante CoTaskMemFree, una función Win32 estándar.

Este método es opcional. Para obtener más información, consulte Interfaces obligatorias y opcionales.

Requisitos

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

Consulte también

Interfaz IMDSPStorage

WMDMRIGHTS