FileDrmNotifyEnable
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
9/8/2008
Essa função registra um aplicativo com o provedor FDRM para atualizações quando direitos atualizados são recebidos sobre o dispositivo.
Syntax
HRESULT FileDrmNotifyEnable (
LPCTSTR pszFileName,
LPTSTR pszValueName,
DWORD cchValueLen
);
Parameters
- pszFileName
[no] Totalmente caminho qualificado para o arquivo para que as notificações devem ser recebida.
- pszValueName
[out] Ponteiro para uma reserva a ser preenchido com o nome de um valor DWORD Registro que é atualizado quando os direitos associado com a alteração objeto. O seqüência de caracteres retornada sempre devem ser terminado com um NULL como longo como caractere cchValueLen é maior ou igual a um.
cchValueLen
[no] Comprimento das pszValueName reserva. Uma reserva de tamanho MAX_PATH sempre deve ser suficiente para manter o seqüência de caracteres retornado. Passar em um menor reserva irá causar essa função para retornar E_INSUFFICIENT_BUFFER se a reserva for muito pequeno para reter a seqüência de caracteres retornada, incluindo o NULL terminador.MAX_PATH é um padrão Windows constante para indicar o comprimento máximo de exigido de reserva. Se o tamanho do buffer que é passado é MAX_PATH, em seguida, a função não falhará porque a reserva é muito pequena, embora ele pode falhar por outros motivos.
Return valores:
A 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 |
|---|---|
E_FDRM_NOPROVIDER |
Nenhum provedor encontrado. |
E_FDRM_NOTDRMOBJECT |
O destino não é um objeto FDRM. |
E_INSUFFICIENTBUFFER |
A reserva apontada pelo pszValueName é muito pequeno para conter o seqüência de caracteres retornado. |
Remarks
No sucesso de psValueName é preenchido com o nome de uma valor do Registro que pode ser monitorado pelo aplicativo. Um novo valor do Registro pode foram criados no Registro. Esses valores devem estar sob a chave Registro HKEY_CURRENT_USER\FDRM\Monitor.
Um aplicativo que requer notificação quando uma atualização de renovação direitos chegou pode usar essa função com o RegistryNotifyxxxx funções para receber notificações de provedor de FDRM.
O provedor FDRM usa o nome do arquivo Passed-in para gerar o nome de uma valor do Registro que é usado como um proxy para o arquivo. O pode aplicativo chamado e registrar para notificações Registro usando esse valor. Quando o provedor FDRM altera a armazenar direitos ela também grava o novo valor direitos FDRRF_* para que valor do Registro proxy. Para uma tabela dos direitos de FDRRF_*, consulte o FileDrmCommitRights da função dwRight Parâmetro.
O provedor FDRM referências chamadas contagem para FileDrmNotifyEnable e FileDrmNotifyDisable Somente Interrompe a atualização e remove o valor do Registro quando o contagem de referência vai para 0. O provedor FDRM também monitora os processos e remove pendente todas as referências para a notificação após sair processo. Registros por múltiplo processos ou segmentos em um único processo que referir para o mesmo nome do arquivo deve retornar o mesmo nome valor do Registro para ser monitorado.
O provedor FDRM também monitora chamadas para DeleteFile e remove qualquer pendente notificações quando um arquivo FDRM-Protected é excluído.
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 |