Compartilhar via

Método IWMDMStorage4::GetRightsWithProgress (mswmdm.h)

  • Artigo

O método GetRightsWithProgress recupera as informações de direitos do objeto de armazenamento, fornecendo um mecanismo de retorno de chamada para monitorar o progresso.

Sintaxe

HRESULT GetRightsWithProgress(
  [in]  IWMDMProgress3 *pIProgressCallback,
  [out] PWMDMRIGHTS    *ppRights,
  [out] UINT           *pnRightsCount
);

Parâmetros

[in] pIProgressCallback

Ponteiro opcional para uma interface IWMDMProgress3 a ser usada pelo Windows Media Gerenciador de Dispositivos para relatar o progresso de volta ao aplicativo.

[out] ppRights

Ponteiro para uma matriz de estruturas WMDMRIGHTS que contêm as informações de direitos de objeto de armazenamento. A memória dessa matriz é alocada por Gerenciador de Dispositivos do Windows Media. Quando o aplicativo de chamada terminar de acessar essa matriz, a memória deverá ser liberada usando CoTaskMemFree.

[out] pnRightsCount

Ponteiro para o número de estruturas WMDMRIGHTS na matriz ppRights .

Retornar valor

O método retorna um HRESULT. Todos os métodos de interface no Windows Media Gerenciador de Dispositivos podem retornar qualquer uma das seguintes classes de códigos de erro:

  • Códigos de erro COM padrão
  • Códigos de erro do Windows convertidos em valores HRESULT
  • Códigos de erro de Gerenciador de Dispositivos do Windows Media
Para obter uma ampla lista de possíveis códigos de erro, consulte Códigos de erro.

Comentários

Os direitos de objeto descrevem as permissões de uso para conteúdo de mídia digital. Por exemplo, a estrutura WMDMRIGHTS pode conter informações sobre quantas vezes um arquivo pode ser reproduzido e quem pode reproduzi-lo.

A recuperação de direitos de um arquivo licenciado às vezes pode ser uma solicitação longa; essa função permite que uma solicitação de direitos seja executada de forma assíncrona.

O provedor de conteúdo seguro pode gerar notificações de evento no retorno de chamada pIProgressCallback , além das notificações de progresso. Exemplos desses eventos incluem a aquisição de um relógio seguro, a inicialização do DRM e assim por diante. Esses eventos são descritos em IWMDMProgress3::P rogress3.

Esse método é idêntico a IWMDMStorage::GetRights, exceto que retorna o progresso e não fornece um MAC para verificação de parâmetro.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho mswmdm.h
Biblioteca Mssachlp.lib

Confira também

IWMDMStorage4 Interface