CAtlTransactionManager::CreateFile

Crea o si apre un file, un flusso di file, o una directory come operazione di processo.

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

Parametri

• lpFileName
  Il nome di un oggetto da creare o aprire.

• dwDesiredAccess
  L'accesso all'oggetto, che può essere riepilogatoe come lettura, scrittura, sia, o nessuno (zero).I valori vengono utilizzati sono GENERIC_READ, GENERIC_WRITE, o entrambi: GENERIC_READ | GENERIC_WRITE.

• dwShareMode
  La modalità di condivisione di un oggetto, che può essere letto, scrittura, entrambi, eliminazione, tutti questi elementi, oppure none: 0, FILE_SHARE_DELETE, FILE_SHARE_READ, FILE_SHARE_WRITE.

• lpSecurityAttributes
  Un puntatore a una struttura di SECURITY_ATTRIBUTES contenente un descrittore di sicurezza facoltativo e determina anche indipendentemente dagli handle restituiti possono essere ereditate dai processi figlio.Il parametro può essere NULL.

• dwCreationDisposition
  Un'azione intraprendere i file esistenti e non esiste.Questo parametro deve essere uno dei seguenti valori, che non possono essere combinati: CREATE_ALWAYS, CREATE_NEW, OPEN_ALWAYS, OPEN_EXISTING, o TRUNCATE_EXISTING.

• dwFlagsAndAttributes
  Attributi di file e i flag.Questo parametro può contenere qualsiasi combinazione degli attributi di file disponibili (FILE_ATTRIBUTE_*).Tutti gli altri attributi del file eseguono l'override di FILE_ATTRIBUTE_NORMAL.Questo parametro può inoltre contenere le combinazioni di flag (FILE_FLAG_*) per il controllo del comportamento di buffer, le modalità di accesso e altri flag per uno scopo specifico.Questi vengono combinati con tutti i valori di FILE_ATTRIBUTE_*.

• hTemplateFile
  Un handle valido a un file modello con il diritto di accesso di GENERIC_READ.Il file modello fornisce i relativi attributi e gli attributi estesi per il file che si sta creando.Questo parametro può essere NULL.

Valore restituito

Restituisce un handle che può essere utilizzata per accedere all'oggetto.

Note

Questo wrapper chiama la funzione CreateFileTransacted.

Requisiti

Header: atltransactionmanager.h

Vedere anche

Riferimenti

Classe di CAtlTransactionManager