CAtlTransactionManager::CreateFile

Crea o abre un archivo, una secuencia de archivo, o un directorio como una operación tramitada.

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

Parámetros

• lpFileName
  El nombre de un objeto que se va a crear o abierto.

• dwDesiredAccess
  El acceso al objeto, que se puede resumir leído, escritura, ni (cero).Los valores más utilizados son GENERIC_READ, GENERIC_WRITE, o ambos: GENERIC_READ | GENERIC_WRITE.

• dwShareMode
  El modo compartido de un objeto, que se pueden leer, escribir, ambos, delete, todas estas, o ninguno: 0, FILE_SHARE_DELETE, FILE_SHARE_READ, FILE_SHARE_WRITE.

• lpSecurityAttributes
  Un puntero a una estructura de SECURITY_ATTRIBUTES que contiene un descriptor de seguridad opcional y también determina si el identificador devuelto se puede heredar de procesos secundarios.el parámetro puede ser NULL.

• dwCreationDisposition
  Una acción para adquirir los archivos que existen y no existen.Este parámetro debe ser uno de los valores siguientes, que no pueden combinarse: CREATE_ALWAYS, CREATE_NEW, OPEN_ALWAYS, OPEN_EXISTING, o TRUNCATE_EXISTING.

• dwFlagsAndAttributes
  Atributos de archivo y los indicadores.Este parámetro puede incluir cualquier combinación de los atributos de archivo disponibles (FILE_ATTRIBUTE_*).Todos los demás atributos de archivo reemplazan FILE_ATTRIBUTE_NORMAL.Este parámetro también puede contener combinaciones de los marcadores (FILE_FLAG_*) para el control del comportamiento del almacenamiento en búfer, los modos de acceso, y otros indicadores especial.Se combinan con cualquier valor de FILE_ATTRIBUTE_*.

• hTemplateFile
  un identificador válido a un archivo de plantilla con el derecho de acceso de GENERIC_READ.Atributos de archivo y los atributos extendidos de las fuentes del archivo de plantilla para el archivo que se va a crear.Este parámetro puede ser NULL.

Valor devuelto

Devuelve un identificador que se puede utilizar para tener acceso al objeto.

Comentarios

Este contenedor llama a la función de CreateFileTransacted .

Requisitos

encabezado: atltransactionmanager.h

Vea también

Referencia

Clase de CAtlTransactionManager