Compartilhar via


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

O método GetRights recupera as informações de direitos de um objeto .

Sintaxe

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

Parâmetros

[out] ppRights

Ponteiro para uma matriz de estruturas WMDMRIGHTS que contêm as informações de direitos de objeto de armazenamento. Esse parâmetro está incluído no código de autenticação de mensagem de saída.

[out] pnRightsCount

Ponteiro para o número de estruturas WMDMRIGHTS na matriz ppRights . Esse parâmetro está incluído no código de autenticação de mensagem de saída.

[in, out] abMac

Matriz de oito bytes que contém o código de autenticação de mensagem para os dados de parâmetro desse método. (WMDM_MAC_LENGTH é definido como 8.)

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. Por exemplo, a estrutura WMDMRIGHTS pode conter informações sobre quantas vezes um arquivo pode ser reproduzido e quem pode reproduzi-lo.

A matriz ppRights é alocada por esse método e deve ser liberada pelo aplicativo usando CoTaskMemFree, uma função Win32 padrão.

Esse método é opcional. Para obter mais informações, consulte Interfaces obrigatórias e opcionais.

Requisitos

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

Confira também

IMDSPStorage Interface

WMDMRIGHTS