Partilhar via


CAtlTransactionManager::CreateFile

Cria ou abre um arquivo, um fluxo de arquivos, ou diretório como uma operação transacionada.

inline HANDLE CAtlTransactionManager::CreateFile(
   LPCTSTR lpFileName,
   DWORD dwDesiredAccess,
   DWORD dwShareMode,
   LPSECURITY_ATTRIBUTES lpSecurityAttributes,
   DWORD dwCreationDisposition,
   DWORD dwFlagsAndAttributes,
   HANDLE hTemplateFile
);

Parâmetros

  • lpFileName
    O nome de um objeto a ser criado ou aberto.

  • dwDesiredAccess
    Acesso ao objeto, que pode ser de resumo como ler, gravar, ou nenhuma (zero).Os valores usados mais comumente são GENERIC_READ, GENERIC_WRITE, ou ambos: GENERIC_READ | GENERIC_WRITE.

  • dwShareMode
    Compartilhando o modo de um objeto, que pode ser lido, gravação, ambos, exclusão, todos esses, ou nenhuma: 0, FILE_SHARE_DELETE, FILE_SHARE_READ, FILE_SHARE_WRITE.

  • lpSecurityAttributes
    Um ponteiro a estrutura de SECURITY_ATTRIBUTES que contém um descritor de segurança opcional e também determina se a alça retornado pode ser herdada pelos processos filho.o parâmetro pode ser NULL.

  • dwCreationDisposition
    Executar uma ação em arquivos que existe e não existirem.Este parâmetro deve ser um dos seguintes valores, que não podem ser combinados: CREATE_ALWAYS, CREATE_NEW, OPEN_ALWAYS, OPEN_EXISTING, ou TRUNCATE_EXISTING.

  • dwFlagsAndAttributes
    Os atributos e sinalizadores de arquivo.Este parâmetro pode incluir qualquer combinação de atributos de arquivo disponíveis (FILE_ATTRIBUTE_*).Todos outros atributos de arquivo substituem FILE_ATTRIBUTE_NORMAL.Este parâmetro também pode conter combinações dos sinalizadores (FILE_FLAG_*) para o controle do comportamento do buffer, os modos de acesso, e outros sinalizadores de propósito especial.Esses são combinadas com todos os valores de FILE_ATTRIBUTE_*.

  • hTemplateFile
    Um identificador válido em um arquivo de modelo com direitos de acesso de GENERIC_READ.O arquivo de modelo fornece os atributos de arquivo e atributos estendidos para o arquivo que está sendo criado.Este parâmetro pode ser NULL.

Valor de retorno

Retorna um identificador que pode ser usado para acessar o objeto.

Comentários

Esse wrapper chama a função de CreateFileTransacted .

Requisitos

Cabeçalho: atltransactionmanager.h

Consulte também

Referência

Classe de CAtlTransactionManager