FileDrmCreateFile

9/8/2008

Essa função permite que um FDRM-habilitado aplicativo para aberto de conteúdo FDRM-protected. Essa função é usada no local do padrão Win32 CreateFile função.

Syntax

HRESULT FileDrmCreateFile (
  LPCTSTR pszFileName,
  DWORD dwDesiredAccess,
  DWORD dwShareMode,
  LPSECURITY_ATTRIBUTES lpSecurityAttributes,
  DWORD dwCreationDisposition,
  DWORD dwFlagsAndAttributes,
  HANDLE hTemplateFile,
  PHANDLE phFile
);

Parameters

• pszFileName
  [no] O caminho totalmente qualificado para o arquivo a ser aberto.

• dwDesiredAccess
  [no] Tipo de acessar para o objeto.

• dwShareMode
  [no] Compartilhar modo para o objeto.

• lpSecurityAttributes
  [no] Ignorado, defina como NULL.

• dwCreationDisposition
  [no] Como identificador existentes e novos arquivos.

• dwFlagsAndAttributes
  [no] Atributos de arquivo para o arquivo.

• hTemplateFile
  [no] Ignorado, defina como NULL.

• phFile
  [out] Ponteiro para uma variável identificador que contém o identificador de arquivo se o chamar é bem-sucedido.

Return Value

In addition to o código de retorno HRESULT, o valor apontado pelo phFile Deve ser definido como INVALID_HANDLE_VALUE se um erro é retornado.

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
S_FDRM_NOPROVIDER	Êxito, mas nenhum provedor FDRM foi encontrado. O valor apontado pelo pfDRM é FALSE.
S_FDRM_NOTDRMOBJECT	Bem-sucedidos, mas o objeto apontado não é um objeto FDRM. O valor apontado pelo pfDRM é FALSE.

Remarks

Use o CloseHandle função para fechar o identificador retornado desta função.

Essa função é usada para substituir o padrão Win32 CreateFile API para aplicativos que são FDRM habilitado. FileDrmCreateFile Retorna qualquer erro que ocorre durante a chamar como o HRESULT criado pelo HRESULT_FROM_WIN32 chamado sobre o valor retornado da GetLastError(). FileDrmCreateFile se comporta da mesma maneira que CreateFile Com o seguinte exceções:

Caso 1: Quando FileDrmCreateFile Abre de conteúdo FDRM para uso sob a seguinte condições:

• Um provedor FDRM está instalado.
• O arquivo que está sendo criado já existe e contém de conteúdo FDRM-protected.
• O dwDesiredAccess parâmetro está definido como GENERIC_READ.
• O dwCreationDisposition parâmetro está definido como OPEN_EXISTING.
  Nesta maiúsculas e minúsculas FileDrmCreateFile Abre o arquivo em tal forma que subseqüentes chama para ReadFile Retorna a versão não criptografada do de conteúdo do arquivo, que ele possa ser usado, o aplicativo.

Case 2: Quando FileDrmCreateFile Tenta aberto de conteúdo FDRM de acesso de gravação sob a seguinte condições:

• Um provedor FDRM está instalado.
• O arquivo que está sendo criado já existe e contém de conteúdo FDRM-protected.
• O dwDesiredAccess parameteris definido como GENERIC_WRITE.
  Nesta maiúsculas e minúsculas FileDrmCreateFile Não será aberto o arquivo para evitar aplicativos substituam inadvertidamente protegidos de conteúdo.

Case 3: Quando FileDrmCreateFile tenta excluir ou truncar de conteúdo FDRM sob a seguinte condições:

• Um provedor FDRM está instalado.
• O arquivo que está sendo criado já existe e contém de conteúdo FDRM-protected.
• O dwCreationDisposition parâmetro está definido como CREATE_ALWAYS ou TRUNCATE_EXISTING.
  Nesta maiúsculas e minúsculas FileDrmCreateFile Não será aberto o arquivo na ordem para evitar aplicativos substituam inadvertidamente protegidos de conteú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

See Also

Reference

FDRM API Reference
FDRM Functions