|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| Yes
| Import Library
| kernel32.lib
| Header File
| winbase.h
| Unicode
| No
| Platform Notes
| None
|
|
|
_lcreat
The _lcreat function creates or opens a specified file. This function is provided for
compatibility with 16-bit versions of Windows. Win32-based applications should use
the CreateFile function.
HFILE _lcreat(
LPCSTR lpPathName,
| // pointer to name of file to open
| int iAttribute
| // file attribute
| );
|
|
Parameters
lpPathName
Pointer to a null-terminated string that names the file to be opened. The
string must consist of characters from the Windows ANSI character set.
iAttribute
Specifies the file attributes. This parameter must be one of the following
values:
Value
| Meaning
| 0
| Normal (can be read from or written to without restriction).
| -
| Read only (cannot be opened for write)
| -
| Hidden (not found by directory search)
| 4
| System (not found by directory search)
|
Return Values
If the function succeeds, the return value is a file handle.
If the function fails, the return value is HFILE_ERROR. To get extended error
information, call GetLastError.
Remarks
If the file does not exist, the _lcreat function creates a new file and opens it for writing. If the file exists, _lcreat truncates the file size to zero and opens it for reading and writing. When
the function opens the file, the pointer is set to the beginning of the file.
The _lcreat function should be used carefully. It can open any file, even one already
opened by another function.
See Also
CreateFile, _lopen
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|