Egy állomány használatban van-e?

CreateFile

HANDLE CreateFile(

LPCTSTR lpFileName,
DWORD dwDesiredAccess,
DWORD dwShareMode,
LPSECURITY_ATTRIBUTES lpSecurityAttributes,
DWORD dwCreationDispostion,
DWORD dwFlagsAndAttributes,
HANDLE hTemplateFile

);

A CreateFile API függvény sokfajta objektum létrehozására és megnyitására alkalmas. Többek között létrehozhatunk vele új állományokat vagy megnyithatunk már létezőket.

Paraméterek

lpFileName

A létrehozandó vagy megnyitandó állomány neve.

dwDesiredAccess

A megadott állományhoz történő hozzáférés módját határozza meg. GENERIC_READ esetén olvasásról, GENERIC_WRITE esetén pedig írásról van szó. A két paraméter egyszerre is megadható, ilyenkor a hozzáférés módja írás-olvasás.

dwShareMode

Számunkra ez a kulcsfontosságú paraméter. Ez határozza meg, hogy a megadott állomány használata milyen formában osztható meg az egyes azonosítók között. Amikor egy program használja a megadott állományt, akkor a rendszerben már létezik egy azonosító, ami erre az állományra mutat. Ha itt 0 paramétert adunk meg, akkor az állomány nem nyitható meg, csak akkor, ha a rendszer még nem tartalmaz egyetlen azonosítót sem, amely erre az állományra mutatna.

lpSecurityAttributes

Itt csak Nil érték szerepelhet.

dwCreationDispostion

Ebben a paraméterben adhatjuk meg, hogy új állományt szeretnénk-e létrehozni, vagy már létezőt megnyitni. Új állomány létrehozása esetén a CREATE_NEW, megnyitás esetén az OPEN_EXISTING paramétereket használhatjuk.

dwFlagsAndAttributes

Ebben a paraméterben megadhatjuk a fájl attribútumát. Az itt szereplő értékek a következők lehetnek: FILE_ATTRIBUTE_ARCHIVE, FILE_ATTRIBUTE_HIDDEN, FILE_ATTRIBUTE_NORMAL, FILE_ATTRIBUTE_READONLY, FILE_ATTRIBUTE_SYSTEM.

hTemplateFile

Itt 0 értéknek kell szerepelnie.

Visszatérési érték

Egy HFile típusú azonosító, amely a létrehozott vagy megnyitott objektumra mutat.