FileDrmCommitRights

9/8/2008

Essa função permite que um aplicativo para confirmação de direitos a serem usados para protegidos de conteúdo.

Syntax

HRESULT FileDrmCommitRights (
  HANDLE hFile,
  DWORD dwRight,
  DWORD dwFlags
);

Parameters

• hFile
  [no] Identificador para o arquivo que contém o de conteúdo para ser usado. O arquivo deve ter sido aberto usando FileDrmCreateFile.

• dwRight
  [no] O direito que o aplicativo especifica o uso. Somente um direito pode ser especificado. 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 FileDrmCommitRights. Este parâmetro é 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. Esta máscara de bits permite que o aplicativo chamado para garantir que o 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 uma peça 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.

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 é de conteúdo FDRM-protected.
E_FDRM_NOTALLOWED	Não é possível verificar direitos. A operação não permitida.
E_FDRM_LICENSEPENDING	Não é possível verificar direitos. A licença está pendente.

Remarks

Confirma os direitos associado com um objeto. O aplicativo chamado deve chamar FileDrmVerifyRights Antes este chamar. Para de conteúdo protegido que só pode ser acessado um número limitado de vezes, é importante para chamar FileDrmCommitRights somente após o de conteúdo protegido tem foi com êxito exibido ou usado.

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