FileDrmVerifyRights

9/8/2008

Essa função permite que um aplicativo para verificar se um objeto tem o exigido direitos antes ele usa de conteúdo FDRM-protected.

Syntax

HRESULT FileDrmVerifyRights (
  HWND hwndParent,
  LPCTSTR pszFileName,
  DWORD dwRight,
  DWORD dwFlags,
  PDWORD pdwRightsStatus
);

Parameters

• hwndParent
  [no] Identificador para a janela proprietária quaisquer elementos interface do usuário such as janelas, caixas diálogo ou mensagem exibidas caixas por essa função.

• pszFileName
  [no] Caminho para o arquivo que contém o de conteúdo FDRM-protected.

• dwRight
  [no] O FDRM direito a ser usada ao abrir o de conteúdo FDRM-protected. Este é o direito especificado pelo aplicativo. Use o máscara de bits para especificar somente um direito em um tempo. A seguinte tabela mostra os possíveis valores para dwRight.

  Sinalizador	Máscara de bits	Descrição
  FDRRF_PLAY	0 x 00000001	Reprodução áudio/vídeo de conteúdo.
  FDRRF_DISPLAY	0 x 00000002	Exibir imagens.
  FDRRF_EXECUTE	0x00000004	Execute aplicativos.
  FDRRF_PRINT	0x00000008	Imprima de conteúdo.
  FDRRF_FORWARD	0x00000010	O conteúdo pode ser encaminhado.

• dwFlags
  [no] Sinalizadores para controle o comportamento de FDRM_VerifyRights. Este é um máscara de bits de FDRVF_* sinalizador valores. A seguinte tabela mostra os possíveis valores para dwFlags.

  Sinalizador	Máscara de bits	Descrição
  FDRVF_NOUI	0 x 00000001	Fazer não exibir nenhum interface do usuário. Isso permite que o aplicativo chamado para garantir que este irá chamar não bloco aguardando entrada do usuário.
  FDRVF_NORENEW	0 x 00000002	Nenhum renovação direitos. Não tenta atualização os direitos associado com um pedaço de de conteúdo, através de interação com usuário ou automaticamente.
  FDRVF_VERIFY_CONTINUE	0x00000004	Verificar o uso contínuo do de conteúdo. Especificado quando FileDrmCommitRights foi chamado e retornou com êxito para um pedaço de de conteúdo e o aplicativo consumir do de conteúdo ainda está consumindo a mesma instância do de conteúdo, mas precisa re-Verify direitos. Exemplo, um media player pode começar uma música tocando, mas ser interrompido por um chamar do telefone. Depois de chamar do telefone é concluído o Mídia player irá chamar FileDrmVerifyRights Para verificar se ele ainda tem direitos para continuar jogando que de conteúdo. Este sinalizador pode permitir que de conteúdo para continuar sendo usados even if há não válido mais direitos. De exemplo, se o de conteúdo tiver restrições sobre o número de vezes ele pode ser usado e que contagem de uso passou para zero na chamar a última FileDrmCommitRights, em seguida, o usuário ainda deve ser permitido para usar que de conteúdo até que tenha sido totalmente consumido.

• pdwRightsStatus
  [out] Status de direitos. A seguinte tabela mostra os possíveis valores para dwRight.

  Sinalizador	Máscara de bits	Descrição
  FDRVS_USER_CAN_UPDATE	0 x 00000001	Direitos são inválido, mas o usuário pode atualização-los.
  FDRVS_UPDATE_PENDING	0 x 00000002	Uma atualização direitos está pendente.

Return Value

Esta função pode retornar qualquer HRESULT e o aplicativo devem usar as macros teve êxito e falha para verificar os resultados. A seguinte tabela mostra valores HRESULT adicionais que podem ser retornados.

Valor	Descrição
S_FDRM_NOPROVIDER	Êxito, mas nenhum provedor FDRM encontrado.
S_FDRM_NOTDRMOBJECT	Bem-sucedidos, mas o destino não é um objeto FDRM.
E_FDRM_FILEDELETED	Não é possível verificar direitos. O arquivo é excluído.
E_FDRM_CANCELLED	Não é possível verificar direitos. A operação será cancelada.
E_FDRM_LICENSEPENDING	Não é possível verificar direitos. A licença está pendente.
E_FDRM_NOTALLOWED	Não é possível verificar direitos. A operação não permitida.

Remarks

Antes que um aplicativo possa usar de conteúdo FDRM-Protected-deve chamar esta função para garantir que o objeto pode ser usado como pretendido. Essa função verifica que o objeto tem o apropriado direitos e, se necessário, solicita que o usuário para verificar que eles desejar para consumir direitos ou renovar direitos expirou.

Observação

Quando você usar o FDRM API em um filtro DShow você deve ter o sinalizador FDRVF_NOUI especificados quando você chamar o FileDrmVerifyRights função.

Requirements

Header	fdrm.h
Library	aygshell.lib
Windows Embedded CE	Windows Embedded CE 6.0 and later
Windows Mobile	Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

See Also

Reference

FDRM API Reference
FDRM Functions
FileDrmVerifyRightsEx