Win32-2.13.0.0: A binding to Windows Win32 API.

Copyright(c) Alastair Reid 1997-2003
LicenseBSD-style (see the file libraries/base/LICENSE)
MaintainerEsa Ilari Vuokko <ei@vuokko.info>
Stabilityprovisional
Portabilityportable
Safe HaskellSafe
LanguageHaskell2010

System.Win32.File

Description

A collection of FFI declarations for interfacing with Win32.

Synopsis

Access modes

type AccessMode = UINT Source #

gENERIC_NONE :: AccessMode Source #

gENERIC_READ :: AccessMode Source #

gENERIC_WRITE :: AccessMode Source #

gENERIC_EXECUTE :: AccessMode Source #

gENERIC_ALL :: AccessMode Source #

dELETE :: AccessMode Source #

rEAD_CONTROL :: AccessMode Source #

wRITE_DAC :: AccessMode Source #

wRITE_OWNER :: AccessMode Source #

sYNCHRONIZE :: AccessMode Source #

sTANDARD_RIGHTS_REQUIRED :: AccessMode Source #

sTANDARD_RIGHTS_READ :: AccessMode Source #

sTANDARD_RIGHTS_WRITE :: AccessMode Source #

sTANDARD_RIGHTS_EXECUTE :: AccessMode Source #

sTANDARD_RIGHTS_ALL :: AccessMode Source #

sPECIFIC_RIGHTS_ALL :: AccessMode Source #

aCCESS_SYSTEM_SECURITY :: AccessMode Source #

mAXIMUM_ALLOWED :: AccessMode Source #

fILE_ADD_FILE :: AccessMode Source #

fILE_ADD_SUBDIRECTORY :: AccessMode Source #

fILE_ALL_ACCESS :: AccessMode Source #

fILE_APPEND_DATA :: AccessMode Source #

fILE_CREATE_PIPE_INSTANCE :: AccessMode Source #

fILE_DELETE_CHILD :: AccessMode Source #

fILE_EXECUTE :: AccessMode Source #

fILE_LIST_DIRECTORY :: AccessMode Source #

fILE_READ_ATTRIBUTES :: AccessMode Source #

fILE_READ_DATA :: AccessMode Source #

fILE_READ_EA :: AccessMode Source #

fILE_TRAVERSE :: AccessMode Source #

fILE_WRITE_ATTRIBUTES :: AccessMode Source #

fILE_WRITE_DATA :: AccessMode Source #

fILE_WRITE_EA :: AccessMode Source #

Sharing modes

type ShareMode = UINT Source #

fILE_SHARE_NONE :: ShareMode Source #

fILE_SHARE_READ :: ShareMode Source #

fILE_SHARE_WRITE :: ShareMode Source #

fILE_SHARE_DELETE :: ShareMode Source #

Creation modes

type CreateMode = UINT Source #

cREATE_NEW :: CreateMode Source #

cREATE_ALWAYS :: CreateMode Source #

oPEN_EXISTING :: CreateMode Source #

oPEN_ALWAYS :: CreateMode Source #

tRUNCATE_EXISTING :: CreateMode Source #

File attributes and flags

type FileAttributeOrFlag = UINT Source #

fILE_ATTRIBUTE_READONLY :: FileAttributeOrFlag Source #

fILE_ATTRIBUTE_HIDDEN :: FileAttributeOrFlag Source #

fILE_ATTRIBUTE_SYSTEM :: FileAttributeOrFlag Source #

fILE_ATTRIBUTE_DIRECTORY :: FileAttributeOrFlag Source #

fILE_ATTRIBUTE_ARCHIVE :: FileAttributeOrFlag Source #

fILE_ATTRIBUTE_NORMAL :: FileAttributeOrFlag Source #

fILE_ATTRIBUTE_TEMPORARY :: FileAttributeOrFlag Source #

fILE_ATTRIBUTE_COMPRESSED :: FileAttributeOrFlag Source #

fILE_ATTRIBUTE_REPARSE_POINT :: FileAttributeOrFlag Source #

fILE_FLAG_WRITE_THROUGH :: FileAttributeOrFlag Source #

fILE_FLAG_OVERLAPPED :: FileAttributeOrFlag Source #

fILE_FLAG_NO_BUFFERING :: FileAttributeOrFlag Source #

fILE_FLAG_RANDOM_ACCESS :: FileAttributeOrFlag Source #

fILE_FLAG_SEQUENTIAL_SCAN :: FileAttributeOrFlag Source #

fILE_FLAG_DELETE_ON_CLOSE :: FileAttributeOrFlag Source #

fILE_FLAG_BACKUP_SEMANTICS :: FileAttributeOrFlag Source #

fILE_FLAG_POSIX_SEMANTICS :: FileAttributeOrFlag Source #

sECURITY_ANONYMOUS :: FileAttributeOrFlag Source #

sECURITY_IDENTIFICATION :: FileAttributeOrFlag Source #

sECURITY_IMPERSONATION :: FileAttributeOrFlag Source #

sECURITY_DELEGATION :: FileAttributeOrFlag Source #

sECURITY_CONTEXT_TRACKING :: FileAttributeOrFlag Source #

sECURITY_EFFECTIVE_ONLY :: FileAttributeOrFlag Source #

sECURITY_SQOS_PRESENT :: FileAttributeOrFlag Source #

sECURITY_VALID_SQOS_FLAGS :: FileAttributeOrFlag Source #

Move file flags

type MoveFileFlag = DWORD Source #

mOVEFILE_REPLACE_EXISTING :: MoveFileFlag Source #

mOVEFILE_COPY_ALLOWED :: MoveFileFlag Source #

mOVEFILE_DELAY_UNTIL_REBOOT :: MoveFileFlag Source #

File pointer directions

type FilePtrDirection = DWORD Source #

fILE_BEGIN :: FilePtrDirection Source #

fILE_CURRENT :: FilePtrDirection Source #

fILE_END :: FilePtrDirection Source #

Drive types

type DriveType = UINT Source #

dRIVE_UNKNOWN :: DriveType Source #

dRIVE_NO_ROOT_DIR :: DriveType Source #

dRIVE_REMOVABLE :: DriveType Source #

dRIVE_FIXED :: DriveType Source #

dRIVE_REMOTE :: DriveType Source #

dRIVE_CDROM :: DriveType Source #

dRIVE_RAMDISK :: DriveType Source #

Define DOS device flags

type DefineDosDeviceFlags = DWORD Source #

dDD_RAW_TARGET_PATH :: DefineDosDeviceFlags Source #

dDD_REMOVE_DEFINITION :: DefineDosDeviceFlags Source #

dDD_EXACT_MATCH_ON_REMOVE :: DefineDosDeviceFlags Source #

Binary types

type BinaryType = DWORD Source #

sCS_32BIT_BINARY :: BinaryType Source #

sCS_DOS_BINARY :: BinaryType Source #

sCS_WOW_BINARY :: BinaryType Source #

sCS_PIF_BINARY :: BinaryType Source #

sCS_POSIX_BINARY :: BinaryType Source #

sCS_OS216_BINARY :: BinaryType Source #

File notification flags

type FileNotificationFlag = DWORD Source #

fILE_NOTIFY_CHANGE_FILE_NAME :: FileNotificationFlag Source #

fILE_NOTIFY_CHANGE_DIR_NAME :: FileNotificationFlag Source #

fILE_NOTIFY_CHANGE_ATTRIBUTES :: FileNotificationFlag Source #

fILE_NOTIFY_CHANGE_SIZE :: FileNotificationFlag Source #

fILE_NOTIFY_CHANGE_LAST_WRITE :: FileNotificationFlag Source #

fILE_NOTIFY_CHANGE_SECURITY :: FileNotificationFlag Source #

File types

type FileType = DWORD Source #

fILE_TYPE_UNKNOWN :: FileType Source #

fILE_TYPE_DISK :: FileType Source #

fILE_TYPE_CHAR :: FileType Source #

fILE_TYPE_PIPE :: FileType Source #

fILE_TYPE_REMOTE :: FileType Source #

Lock modes

type LockMode = DWORD Source #

lOCKFILE_EXCLUSIVE_LOCK :: LockMode Source #

lOCKFILE_FAIL_IMMEDIATELY :: LockMode Source #

GetFileEx information levels

data GET_FILEEX_INFO_LEVELS Source #

Instances

getFileExInfoStandard :: GET_FILEEX_INFO_LEVELS Source #

getFileExMaxInfoLevel :: GET_FILEEX_INFO_LEVELS Source #

Security attributes

data SECURITY_ATTRIBUTES Source #

Constructors

Instances

type PSECURITY_ATTRIBUTES = Ptr SECURITY_ATTRIBUTES Source #

type LPSECURITY_ATTRIBUTES = Ptr SECURITY_ATTRIBUTES Source #

type MbLPSECURITY_ATTRIBUTES = Maybe LPSECURITY_ATTRIBUTES Source #

BY_HANDLE file information

data BY_HANDLE_FILE_INFORMATION Source #

Constructors

Instances

Win32 file attribute data

data WIN32_FILE_ATTRIBUTE_DATA Source #

Constructors

Instances

Helpers

failIfWithRetry :: (a -> Bool) -> String -> IO a -> IO a Source #

like failIfFalse_, but retried on sharing violations. This is necessary for many file operations; see http://support.microsoft.com/kb/316609

failIfWithRetry_ :: (a -> Bool) -> String -> IO a -> IO () Source #

failIfFalseWithRetry_ :: String -> IO Bool -> IO () Source #

File operations

deleteFile :: String -> IO () Source #

copyFile :: String -> String -> Bool -> IO () Source #

moveFile :: String -> String -> IO () Source #

moveFileEx :: String -> Maybe String -> MoveFileFlag -> IO () Source #

setCurrentDirectory :: String -> IO () Source #

createDirectory :: String -> Maybe LPSECURITY_ATTRIBUTES -> IO () Source #

createDirectoryEx :: String -> String -> Maybe LPSECURITY_ATTRIBUTES -> IO () Source #

removeDirectory :: String -> IO () Source #

getBinaryType :: String -> IO BinaryType Source #

HANDLE operations

createFile :: String -> AccessMode -> ShareMode -> Maybe LPSECURITY_ATTRIBUTES -> CreateMode -> FileAttributeOrFlag -> Maybe HANDLE -> IO HANDLE Source #

closeHandle :: HANDLE -> IO () Source #

getFileType :: HANDLE -> IO FileType Source #

flushFileBuffers :: HANDLE -> IO () Source #

setEndOfFile :: HANDLE -> IO () Source #

setFileAttributes :: String -> FileAttributeOrFlag -> IO () Source #

getFileAttributes :: String -> IO FileAttributeOrFlag Source #

getFileAttributesExStandard :: String -> IO WIN32_FILE_ATTRIBUTE_DATA Source #

getFileInformationByHandle :: HANDLE -> IO BY_HANDLE_FILE_INFORMATION Source #

Reading/writing

Some operations below bear the win32_ prefix to avoid shadowing operations from Prelude.

data OVERLAPPED Source #

Constructors

Instances
Instance details

Defined in System.Win32.File

type LPOVERLAPPED = Ptr OVERLAPPED Source #

type MbLPOVERLAPPED = Maybe LPOVERLAPPED Source #

win32_ReadFile :: HANDLE -> Ptr a -> DWORD -> Maybe LPOVERLAPPED -> IO DWORD Source #

win32_WriteFile :: HANDLE -> Ptr a -> DWORD -> Maybe LPOVERLAPPED -> IO DWORD Source #

setFilePointerEx :: HANDLE -> LARGE_INTEGER -> FilePtrDirection -> IO LARGE_INTEGER Source #

File notifications

findFirstChangeNotification :: String -> Bool -> FileNotificationFlag -> IO HANDLE Source #

findNextChangeNotification :: HANDLE -> IO () Source #

findCloseChangeNotification :: HANDLE -> IO () Source #

Directories

data FindData Source #

getFindDataFileName :: FindData -> IO FilePath Source #

findFirstFile :: String -> IO (HANDLE, FindData) Source #

findNextFile :: HANDLE -> FindData -> IO Bool Source #

findClose :: HANDLE -> IO () Source #

DOS device flags

defineDosDevice :: DefineDosDeviceFlags -> String -> Maybe String -> IO () Source #

areFileApisANSI :: IO Bool Source #

setFileApisToOEM :: IO () Source #

setFileApisToANSI :: IO () Source #

setHandleCount :: UINT -> IO UINT Source #

getLogicalDrives :: IO DWORD Source #

getDiskFreeSpace :: Maybe String -> IO (DWORD, DWORD, DWORD, DWORD) Source #

setVolumeLabel :: Maybe String -> Maybe String -> IO () Source #

File locks

lockFile Source #

Arguments

:: HANDLE

CreateFile handle

-> LockMode

Locking mode

-> DWORD64

Size of region to lock

-> DWORD64

Beginning offset of file to lock

-> IO BOOL

Indicates if locking was successful, if not query getLastError.

Locks a given range in a file handle, To lock an entire file use 0xFFFFFFFFFFFFFFFF for size and 0 for offset.

unlockFile Source #

Arguments

:: HANDLE

CreateFile handle

-> DWORD64

Size of region to unlock

-> DWORD64

Beginning offset of file to unlock

-> IO BOOL

Indicates if unlocking was successful, if not query getLastError.

Unlocks a given range in a file handle, To unlock an entire file use 0xFFFFFFFFFFFFFFFF for size and 0 for offset.

AltStyle によって変換されたページ (->オリジナル) /